PHPInjector

Install

The runtime has one dependency: the PSR-11 container contract.

composer require dvictorjhg/php-injector

Providers

A provider is a stored value or a lazy class string. Closures are supplied as values, not executed as factories.

<?php

declare(strict_types=1);

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

use PHPInjector\DI\Injector;

final class Logger
{
}

$logger = new Logger();
$dsn = 'mysql:host=db;dbname=app';

$injector = new Injector();
$injector->addProvider(Logger::class, $logger);
$injector->addProvider('db.dsn', $dsn);

echo Injector::inject('db.dsn');

mysql:host=db;dbname=app

Alias an interface and inject configuration

Register constructor dependencies explicitly. Direct class targets can be constructed without registration, but their required typed parameters need providers.

<?php

declare(strict_types=1);

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

use PHPInjector\DI\Attributes\Inject;
use PHPInjector\DI\Injector;

interface Formatter
{
    public function format(string $value): string;
}

final class TextFormatter implements Formatter
{
    public function format(string $value): string
    {
        return strtoupper($value);
    }
}

final class Report
{
    public function __construct(
        public Formatter $formatter,
        #[Inject('env')] public string $environment,
    ) {
    }
}

$injector = new Injector([
    Formatter::class => TextFormatter::class,
    'env' => 'production',
]);
$report = Injector::inject(Report::class);
echo $report->formatter->format($report->environment) . PHP_EOL;
var_dump(Injector::inject(TextFormatter::class) === $report->formatter);

PRODUCTION
bool(true)

Use the PSR-11 store directly

Container stores values without constructing classes or invoking closures. Null is a present value; missing identifiers throw NotFoundException. set() replaces entries and unset() removes them.

<?php

declare(strict_types=1);

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

use PHPInjector\Container\Container;
use Psr\Container\NotFoundExceptionInterface;

$container = new Container(['env' => 'dev', 'optional' => null]);
var_dump($container->has('optional'));
$container->set('env', 'production');
echo $container->get('env') . PHP_EOL;
$container->unset('env');
echo count($container) . PHP_EOL;
try {
    $container->get('env');
} catch (NotFoundExceptionInterface $exception) {
    echo $exception->getMessage();
}

bool(true)
production
1
No entry was found for env identifier.

Inject a closure as a value

Resolving a closure provider returns the closure itself. Invoke it in your consumer, or pass a callable directly to Injector::inject() to execute it with resolved parameters.

<?php

declare(strict_types=1);

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

use PHPInjector\DI\Injector;

$format = static fn (string $value): string => strtoupper($value);
$injector = new Injector([Closure::class => $format]);
var_dump(Injector::inject(Closure::class) === $format);
echo Injector::inject(
    static fn (Closure $format): string => $format('ready'),
);

bool(true)
READY

Resolution and lifecycle limits