niletphp/dependency-container

The NiletPHP dependency injection container.

v1.0.0 2018-04-21 10:13 UTC

Requires

• php: >=7.0

Requires (Dev)

• phpunit/phpunit: ~5.7

MIT

• Tsvetelin Tsonev

README

Dependency container which provides an easy way for managing dependencies in your PHP projects.

Requirements

PHP >= 7.0

Install

Composer

{
    "require": {
        "niletphp/dependency-container": ">=v1.0"
    }
}

Examples

$dc = new Nilet\Components\Container\DependencyContainer();

Resolve dependencies for a given concrete and return a new instance of it

$dc->create("Nilet\Foo");

Bind a concrete to interface. Resolving such binding will always return new concrete instance

$dc->bind("Nilet\FooInterface", "Nilet\Foo");
$dc->bind("Nilet\FooInterface", function ($dc) {
    return new Nilet\Foo();
});
$dc->create("Nilet\FooInterface");

Share a concrete (singleton).

$dc->share("Nilet\Foo");
$dc->share("Nilet\Foo", function ($dc) {
    return new Nilet\Foo();
});

Binding a concrete (singleton) to an Interface

$dc->bindShared("Nilet\FooInterface", "Nilet\Foo");
$dc->bindShared("Nilet\FooInterface", function ($dc) {
    return new Nilet\Foo();
});

Register a concrete instance (singleton).

$foo = new Nilet\Foo();
$dc->instance("Nilet\Foo", $foo);

Retrieve a concrete.

$dc->get("Nilet\Foo");

$dc->bindShared("Nilet\FooInterface", "Nilet\Foo");
$dc->get("Nilet\FooInterface");

Determine if a given concrete (singleton) has been resolved.

$dc->bindShared("Nilet\FooInterface", "Nilet\Foo");
$dc->get("Nilet\FooInterface");
if ($dc->isResolved("Nilet\FooInterface")) { // evaluates to true
    // do something
} else {
    // do something else
}

Determine if a given concrete is shared.

$dc->share("Nilet\Foo");
if ($dc->isShared("Nilet\Foo")) { // evaluates to true
    // do something
} else {
    // do something else
}

Determine if a given interface is bound.

$dc->bind("Nilet\FooInterface", "Nilet\Foo");
if ($dc->isBound("Nilet\FooInterface")) { //evaluates to true
    // do something
} else {
    // do something else
}

Determine if a given interface is bound/shared.

$dc->bindShared("Nilet\FooInterface", "Nilet\Foo");
if ($dc->isBoundShared("Nilet\FooInterface")) { //evaluates to true
    // do something
} else {
    // do something else
}