PHPackages                             maarky/lazy - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Utility & Helpers](/categories/utility)
4. /
5. maarky/lazy

ActiveLibrary[Utility & Helpers](/categories/utility)

maarky/lazy
===========

Lazy Loader

1.0.0(8y ago)014Apache2PHPPHP >=7.0

Since Oct 31Pushed 8y ago1 watchersCompare

[ Source](https://github.com/maarky/lazy)[ Packagist](https://packagist.org/packages/maarky/lazy)[ RSS](/packages/maarky-lazy/feed)WikiDiscussions master Synced 3d ago

READMEChangelogDependencies (1)Versions (2)Used By (0)

Lazy Loading
============

[](#lazy-loading)

This library provides a basic means of lazy loading. If you are sick of writing code like the following then you can benefit from this class.

```
class Whatever
{
    public $something;

    public function getSomething()
    {
        if(!$something) {
            $this->something = 'something';
        }
        return $this->something;
    }
}

```

There are a number of issues with this approach:

- There's annoying boilerplate code.
- The actual value of $something might evaluate as false which means you need more boilerplate code.
- Your class has to know how to get $something.

Usage
-----

[](#usage)

Imagine you have an Author object and a getArticles() metod that returns an array of all articles by this author. If you use this object in 100 places throughout your code but you only need the list of their articles in half of those places you aren't going to want to load the articles every time you create an Author object since the time spent will often be wasted.

The Lazy\\Container class constructor takes a callback that accepts no arguments and returns any value. The get() method calls the function, stores the returned value and returns it. If you ever call the get() method again it will not call your function but will instead just return the previously generated value.

Here's an example where a repository class creates your Author instances:

```
class AuthorRepository
{
    public function find($id)
    {
        //query db for author with the given id
        //resulting an an array called $row

        $function = function() use($id) {
            return $this->articleRepository->findByAuthor($id)
        };
        $row['articles'] = new \maarky\Lazy\Container($function);
        return new Author($row);
    }
}

class Author
{
    public function getArticles()
    {
        return $this->articles->get();
    }
}

```

As you can see, the getArticles() method doesn't need to know anything about how the articles are retrieved or whether or not they have already been retrieved. It just needs to get the value from the Lazy\\Container object and leaves it to that object to worry about the details.

Warning
-------

[](#warning)

It is important to know that this value will only be generated once. This means that it is intended to be immutable. If any change in the application or the object containing the Lazy\\Container object changes and requires a new value for that Lazy\\Container object then you should not use this class for that.

This behavior is intentional and it is a feature, not a bug.

###  Health Score

25

—

LowBetter than 37% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity6

Limited adoption so far

Community7

Small or concentrated contributor base

Maturity58

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 100% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Unknown

Total

1

Last Release

3118d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/c379ef32e175e622fee312c2677e317b2dbaa4158840d6f043e86f67506b81bc?d=identicon)[maarky](/maintainers/maarky)

---

Top Contributors

[![maarky](https://avatars.githubusercontent.com/u/926854?v=4)](https://github.com/maarky "maarky (4 commits)")

---

Tags

phplazy load

###  Code Quality

TestsPHPUnit

### Embed Badge

![Health badge](/badges/maarky-lazy/health.svg)

```
[![Health](https://phpackages.com/badges/maarky-lazy/health.svg)](https://phpackages.com/packages/maarky-lazy)
```

###  Alternatives

[imanghafoori/laravel-anypass

A minimal yet powerful package to help you in development.

21421.6k](/packages/imanghafoori-laravel-anypass)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)