Container Package

PSR-11 dependency injection container.

Installation

composer require lighthouse/container

Basic Usage

use Lighthouse\Container\Container;

$container = new Container();

// Bind implementation
$container->bind(LoggerInterface::class, FileLogger::class);

// Resolve
$logger = $container->get(LoggerInterface::class);

Binding

Class Binding

$container->bind(Logger::class, FileLogger::class);

Closure Binding

$container->bind(Database::class, function ($container) {
    return new Database('localhost', 'root', 'secret');
});

Singletons

$container->singleton(Database::class, function ($container) {
    return new Database('localhost', 'root', 'secret');
});

Same instance returned every time.

Instances

$logger = new FileLogger('/var/log/app.log');
$container->instance(Logger::class, $logger);

Resolving

Get

$service = $container->get(UserService::class);

Has

if ($container->has(Logger::class)) {
    // ...
}

Make (always new)

$service = $container->make(UserService::class);

Auto-Wiring

The container automatically resolves constructor dependencies:

class UserService
{
    public function __construct(
        private Database $db,
        private Logger $logger
    ) {}
}

// Container creates Database, Logger, then UserService
$service = $container->get(UserService::class);

Method Injection

$container->call($controller, 'index', [
    'id' => 123,
    'request' => $request,
]);

PSR-11 Compliance

Implements Psr\Container\ContainerInterface:

use Psr\Container\ContainerInterface;

function bootstrap(ContainerInterface $container) {
    $logger = $container->get(LoggerInterface::class);
}