slightly-interactive/di-container

A dependency injection container.

1.0.1 2021-01-26 19:14 UTC

Requires

• php: >=7.1
• phpunit/phpunit: ^9.2
• psr/container: ^1.0

Provides

• psr/container-implementation: ^1.0

MIT

• David Laurie

• container
• dependency
• di
• injection
• PSR-11
• psr11
• dicontainer

README

Overview

DI Container is a PSR-11 compliant auto-wiring Dependency Injection container.

Usage

Instantiate the container:

use SlightlyInteractive\DI;

$container = new Container();

Resolve classes:

$myClass = $container->get(MyClass::class);

By default, the container will pass the exact same instance every time the same class is requested.

You can tell the container to create a new instance every time a given class is requested:

$container->set(MyClass::class)->factory();

Or when you instantiate the container you can tell it to create a new instance every time, for every class:

$container = new Container(Container::INSTANTIATE_FACTORY);

And then you can tell it to make specific classes use a single instance:

$container->set(MySingleton::class)->singleton();

You can map interfaces to a particular concrete instance:

$container->set(MyInterface::class)->map(MyClass::class);

You can do this for a particular class:

class MyDependent
{
    public function __construct(
        RealClass $realClass,
        MyInterface $myInterface
    ) {
        ...
    }
    
    ...
}

$container->set(MyDependent::class)
    ->argument('myInterface', MyClass::class);
    

You can use the argument parameter to pass non-object values to arguments, too:

class MyDependent
{
    public function __construct(
        RealClass $realClass,
        string $apiKey
    ) {
        ...
    }
    
    ...
}

$container->set(MyDependent::class)
    ->argument('apiKey', $_ENV['API_KEY']);