ultra-lite / container
Installs: 17 388
Dependents: 1
Suggesters: 0
Security: 0
Stars: 21
Watchers: 4
Forks: 0
Open Issues: 1
Requires
- php: ^7.4 || ^8.0
- psr/container: ^1.0
Requires (Dev)
- behat/behat: ^3.8
- phpspec/phpspec: ^7.0
- phpunit/phpunit: ^9.5
README
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
.