README.md

PHPBench Service Container

This is a simple but powerful dependency injection container:

• Extendable (a.k.a service providers);
• Configurable;
• Taggable services;
• Extensions provide default configuration;

This container was developed incidentally for PHPBench, and is not a very polished library, but I like it.

Simple usage

$container = Container::create();
$container->register('foobar', function (Container $container) {
    return new \stdClass();
});

Extending

Extension classes should be passed as the first argument to the container (the user configuration is the second argumnet).

$container = new Container(
    [
        MyExtension::class
    ],
    [
        'foo.bar' => 'my_new_value',
    ]
);

class MyExtension implements ExtensionInterface
{
    public function load(Container $container)
    {
        $container->register('my_service', function (Container $container) {
            $service = new MyService(
                $container->getParameter('foo_bar'),
                $container->get('some_other_service')
            );

            // get all tagged services and add them to the instantiated object
            foreach ($container->getServiceIdsForTag('my_tag') as $serviceId) {
                $service->add($container->get($serviceId));
            }
        });

        $container->register('tagged_service', function (Container $container) {
            $service = new MyService(
                $container->getParameter('foo_bar'),
                $container->get('some_other_service')
            );

            return $service;
        }, [ 'my_tag' => [ 'attribute_1' => 'foo' ]); // optional tag attributes
    }

    /**
     * Return the default parameters for the container.
     *
     * @return array
     */
    public function getDefaultConfig()
    {
        return [
            'foo_bar' => 'this is foo'
        ];
    }
}

Tagging

You can use tags (as in the above example) to collect services from extensions and do things with them, but be aware that this will cause all of the involved classes to be instantaited. Which is not very efficient.