strident/container

Dependency injection container component designed for ease of use and speed. Built for Trident. Heavily inspired by Pimple.

Container

, _(*1)

Dependency injection container component designed for ease of use and speed. Built for Trident. Heavily inspired by [Pimple][1]., _(*2)

Installation

Installation is available via Composer. Add the package to your composer.json:, _(*3)

$ composer require strident/container ~2.0

Usage

The container is incredibly simple to instantiate. Simply do the following:, _(*4)

use Strident\Container\Container;

$container = new Container();

Defining Services

From there, you can define services like so:, _(*5)

// 'Service' class defined somewhere, and 'dependency_name' service defined

$container->set("service_name", function($container) {
    return new Service($container->get("dependency_name"));
});

The services are lazy loaded (i.e. nothing is instantiated until it is called)., _(*6)

Extending a Service After Definition

You may also extend services once they have been defined (for example, if you wish to augment a service, alter settings, swap out dependencies etc). But note that once a service is used, it becomes locked and cannot be modified further., _(*7)

$container->extend("service_name", function($service, $container) {
    $service->doSomething();
    $service->addSomething($container->get("dependency_name"));

    return $service;
});

Defining Factory Services

If you wish to return a new instance of your service every time instead of the same instance, you may define a factory service like so:, _(*8)

$container->set("service_name", $container->factory(function($container) {
    return new Service($container->get("dependency_name"));
}));

Parameters

Parameters are get / set by accessing the container like an array:, _(*9)

// Set
$container["foo"] = "A parameter can be anything";

// Get
$foo = $container["foo"];