ultra-lite / container

An extremely lightweight DI container in PHP

Ultra-Lite Container

An ultra-lightweight DI container. The Ultra-Lite container is PSR-11 compliant. (Previous versions supported container-interop instead.)

Use anonymous functions as factories to specify your services.

This container also supports the Delegate Lookup pattern, and comes with a basic composite container.

Usage

Setting services individually

$container->set(
    'service-id',
    function (\Psr\Container\ContainerInterface $container) {
        return new \stdClass();
    }
);

Setting services from a config file

Add factory closures to the container inline, or using a config file as below.

Example config file:

return [
    'service-id' =>
        function (\Psr\Container\ContainerInterface $container) {
            return new \stdClass();
        },
];

Using config file:

$container->configureFromFile('/wherever/config/di.php');

Service retrieval

Get services out of the container like this:

$object = $container->get('service-id');

See if a service exists

Check if something is in the container like this:

$thingExists = $container->has('service-id');

Use with the Delegate Lookup pattern

If you're not using the Delegate Lookup concept from the Container-Interop standard, ignore this bit. If you are, you can do this:

$container = new \UltraLite\Container\Container();
$delegateContainer = new \UltraLite\CompositeContainer\CompositeContainer(); // or any delegate container
$compositeContainer->addContainer($container); // will vary for other composite containers
$container->setDelegateContainer($myCompositeContainer);

The Ultra-Lite Composite Container is an extremely lightweight delegate container you may wish to use.

When the container is asked for a service using get(), it will return it. It will pass the Composite Container into the factory closure, so it is from here that any dependencies of your service will be retrieved.

Alternatives

Ultra-Lite Container was originally inspired by Pimple, which still makes an excellent DI container in PHP. Container-Interop compliant wrappers are available. Another excellent project, Picotainer, is along similar lines, with the principle difference being that the dependencies are defined at the time of instantiation of the container.

Installation

composer require ultra-lite/container

Contributions

Contributions welcome.

You can run the tests with ./vendor/bin/behat -c tests/behat/behat.yml and ./vendor/bin/phpspec r -c tests/phpspec/phpspec.yml.

container's Issues

PSR compatibility

Hello!
We have some problems with PSR compatibility..

[29-Apr-2021 10:21:17 Europe/Moscow] PHP Fatal error: Declaration of UltraLite\Container\Container::get(string $serviceId) must be compatible with Psr\Container\ContainerInterface::get($id) in path_to_project/vendor/ultra-lite/container/src/UltraLite/Container/Container.php on line 47

Unnecessary "use" declaration in "Container.php" file.

Unused dependency in Container.php file:

use Interop\Container\Exception\NotFoundException;

I don't know how to use GIT and can't make a pull request. Sorry.