[
The Thruster Container Component. Container is small self contained dependency injection container implementing ContainerInterface interface.
Via Composer
$ composer require thruster/containerJust create instance of Container:
<?php
use Thruster\Component\Container;
$container = new Container();Also you can pass preset array of values to constructor.
<?php
use Thruster\Component\Container;
$values = [
'render.engine' => function ($container) {
return new RenderEngine($container->get('translation.engine'));
},
'translation.engine' => function () {
return new TranslationEngine();
}
];
$container = new Container($values);Container has a bunch of simple named functions to use container: has, set, get, remove:
<?php
use Thruster\Component\Container;
$container = new Container();
$container->has('render.engine'); // = false
$container->set('render.engine', function ($container) {
return new RenderEngine($container->get('translation.engine'));
});
$container->has('render.engine'); // = true
$renderEngine = $container->get('render.engine');
$container->remove('render.engine');
$container->has('render.engine'); // = falseContainer also support \ArrayAccess
<?php
use Thruster\Component\Container;
$container = new Container();
isset($container['render.engine']); // = false
$container['render.engine'] = function ($container) {
return new RenderEngine($container->get('translation.engine'));
};
isset($container['render.engine']); // = true
$renderEngine = $container['render.engine'];
unset($container['render.engine']);
isset($container['render.engine']); // = falseBy default Container always returns the same instance of identifier, but you can create a factory definition which will return always new instance of identifier.
<?php
use Thruster\Component\Container;
$container = new Container();
$i = 1;
$value = function () use ($i) {
return $i++;
}
$factoryValue = function () use (&$i) {
return $i++;
}
$container->set('normal', $value);
$container->get('normal'); // = 1
$container->get('normal'); // = 1
$container->set('factory', $factoryValue);
$container->get('factory'); // = 1
$container->get('factory'); // = 2Container provides a way to extend container with ContainerProviderInterface
<?php
use Thruster\Component\Container;
use Thruster\Component\ContainerProviderInterface;
$container = new Container();
$provider = new class implements ContainerProviderInterface {
public function register(Container $container)
{
$container->set(....);
}
};
$container->addProvider($provider);- Container throws
NotFoundExceptionif identifier is not found in container. - Container throws
IdentifierFrozenExceptionwhen trying to set definition for already frozen identifier. (Frozen means when value was already used once)
$ composer testPlease see CONTRIBUTING and CONDUCT for details.
Please see License File for more information.