🕐 Lazy-параметры (отложенные значения)

Некоторые параметры могут разрешаться в момент использования, а не во время build Container, такие параметры называются Lazy (ленивые). С помощью таких параметров можно реализовать свою callback функцию, которая будет генерировать зависимость в особо сложных случаях:

Нужно внедрять зависимости не только в конструктор, но и например в методы после создания объекта.
Нужно получить текущий Container, для различных service locator которым требуется текущая реализация ContainerInterface.
Можно генерировать различные значения на основе других, например dsn строку подключения к бд, на основе db_type, db_host, db_name и тд.

Если параметр реализует Lazy interface, то он будет загружаться в runtime.

Пример внедрения зависимостей через метод.

Может быть ситуация когда требуется внедрить зависимость не через конструктор, а через метод или другими более сложными способами.

src/Example.php

<?php

namespace App;

class Example
{
    private \PDO $connection;

    public function setPdo(\PDO $connection)
    {
        // inject via method
        $this->connection = $connection;
    }
}

src/Config.php

<?php

namespace App;

class Config
{
    public function __construct(private array $env)
    {
    }

    public function __invoke(): array
    {
        return [
            \App\Example::class => new \Cekta\DI\Lazy\Closure(
                function (\Psr\Container\ContainerInterface $c) {
                    $example = new \App\Example();
                    $example->setPdo($c->get(\PDO::class));
                    return $example;
                }
            ),
            \PDO::class . '$dsn' => $this->env['DB_DSN'] ?? 'sqlite:./db.sqlite',
        ];
    }
}

bin/build.php

<?php

require_once __DIR__ . '/../vendor/autoload.php';

(new \Cekta\DI\ContainerBuilder(
    entries: [\App\Example::class, \PDO::class],
    fqcn: '\App\Container',
    params: (new \App\Config(getenv() + $_ENV))(),
))->build();

index.php

<?php

reqire_once __DIR__ . '/vendor/autoload.php';

$container = new \App\Container((new Config(getenv() + $_ENV))());
var_dump($container->get(\App\Example::class));

\Cekta\DI\Lazy\Closure использую callback функцию создает любое значение. Вы можете задать любую callback функцию и внедрять любым способом.

Вы можете управлять жизненном циклом данных зависимостей.

Рекомендация:

Если параметры используются внутри LazyClosure, добавьте их в entries для гарантии доступности.
Передавайте зависимости через конструктор.

Пример передачи ContainerInterface в Service Locator.

Service Locator для своей работы может требовать ContainerInterface, чтобы разрешать зависимости.