#Container

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

##Installation

Installation is available via Composer. Add the package to your composer.json:

$ composer require strident/container ~2.0

##Usage

The container is incredibly simple to instantiate. Simply do the following:

useStrident\Container\Container;
$container = newContainer();

###Defining Services

From there, you can define services like so:

// 'Service' class defined somewhere, and 'dependency_name' service defined$container->set("service_name", function($container) {
returnnewService($container->get("dependency_name"));
});

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

###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.

$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:

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

###Parameters

Parameters are get / set by accessing the container like an array:

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