This package is abandoned and no longer maintained. No replacement package was suggested.

A library that provides lazy instantiation logic for a map of objects

Fund package maintenance!


This small library aims at providing a very simple and efficient map of lazy-instantiating objects.

Total Downloads Latest Stable Version Latest Unstable Version Mutation testing badge


Starting with PHP 8.3, dynamic properties are no longer allowed "out of the box". While it is still possible to have dynamic properties via explicit declaration (the #[\AllowDynamicProperties] attribute), the approach of this package is no longer to be considered safe nor efficient long-term.

Based on that, this package is deprecated and abandoned: please use traditional PHP arrays instead.


The suggested installation method is via composer:

composer require ocramius/lazy-map


The current implementation is very simple and allows to define a map of "services" through a LazyMap\CallbackLazyMap:

$map = new \LazyMap\CallbackLazyMap(function ($name) {
    $object = new \stdClass();

    $object->name = $name;

    return $object;

var_dump($map->{'something special'});


The idea behind the library is to avoid un-efficient lazy-loading operations like following:

private function getSomething($name)
    if (isset($this->initialized[$name]) || array_key_exists($name, $this->initialized)) {
        return $this->initialized[$name];

    return $this->initialized[$name] = new Something($name);

This reduces overhead greatly when you'd otherwise call getSomething() thousands of times. That's especially useful when mapping a lot of different services and iterating over them over and over again.


LazyMap actually performs much better than the "un-efficient" example that I've shown above. You can look directly at the performance test suite for details on the tested implementations, but here are some results for you to have an idea of the boost:

Initialized Map Performance:

Method Name Ops/s Relative
initializedArrayPerformance 2,277,272.90002 100.00%
initializedArrayMapPerformance 1,536,988.76108 148.16%
initializedLazyMapPerformance 4,446,227.23514 51.22%

Un-Initialized Map Performance:

Method Name Ops/s Relative
unInitializedArrayPerformance : 1,091,720.80627 100.00%
unInitializedArrayMapPerformance 688,132.30083 158.65%
unInitializedLazyMapPerformance: 912,191.90744 119.68%