slince / di
A flexible dependency injection container
Installs: 204 456
Dependents: 7
Suggesters: 0
Security: 0
Stars: 20
Watchers: 4
Forks: 5
Open Issues: 0
Requires
- php: >=7.4
- dflydev/dot-access-data: ^3.0
- psr/container: ^1.0 || ^2.0
Requires (Dev)
- phpunit/phpunit: ^7.5|^8.0|^9.0
README
This package is a flexible IOC container for PHP with a focus on being lightweight and fast as well as requiring as little configuration as possible. It is an implementation of PSR-11
Installation
Install via composer.
{ "require": { "slince/di": "^3.0" } }
Alternatively, require package use composer cli:
composer require slince/di ^3.0
Usage
Container is dependency injection container. It allows you to implement the dependency injection design pattern meaning that you can decouple your class dependencies and have the container inject them where they are needed.
namespace Acme; class Foo { /** * @var \Acme\Bar */ public $bar; /** * Construct. */ public function __construct(Bar $bar) { $this->bar = $bar; } } class Bar { public $foo; public $baz; public function __construct($foo, $baz) { $this->foo = $foo; $this->baz = $baz; } } $container = new Slince\Di\Container(); $container->register(Acme\Foo::class); $foo = $container->get(Acme\Foo::class); var_dump($foo instanceof Acme\Foo); // true var_dump($foo->bar instanceof Acme\Bar); // true
Make Service References
$container->register('bar', Acme\Bar::class); $container->register('foo', Acme\Foo::class) ->addArgument(new Slince\Di\Reference('bar')); //refer to 'bar' var_dump($container->get('bar') === $container->get('foo')->bar)); // true
Use a Factory to Create Services
Suppose you have a factory that configures and returns a new NewsletterManager
object
by calling the static createNewsletterManager()
method:
class NewsletterManagerStaticFactory { public static function createNewsletterManager($parameter) { $newsletterManager = new NewsletterManager($parameter); // ... return $newsletterManager; } }
// call the static method $container->register( NewsletterManager::class, array(NewsletterManagerStaticFactory::class, 'createNewsletterManager') )->addArgument('foo');
If your factory is not using a static function to configure and create your service, but a regular method, you can instantiate the factory itself as a service too.
// call a method on the specified factory service $container->register(NewsletterManager::class, [ new Reference(NewsletterManagerFactory::class), 'createNewsletterManager' ]);
Create Service Aliases
$container->register(Acme\Foo::class); $container->setAlias('foo-alias', Acme\Foo::class); $foo = $container->get('foo-alias'); var_dump($foo instanceof Acme\Foo); // true
Configure container
- Singleton
$container->setDefaults([ 'share' => false ]); $container->register('foo', Acme\Foo::class); var_dump($container->get('foo') === $container->get('foo')); // false
- Autowiring
$container->setDefaults([ 'autowire' => false, ]); $container->register('foo', Acme\Foo::class) ->addArgument(new Acme\Bar()); // You have to provide $bar var_dump($container->get('foo') instanceof Acme\Foo::class); // true
Container Parameters
$container->setParameters([ 'foo' => 'hello', 'bar' => [ 'baz' => 'world' ] ]); $container->register('bar', Acme\Bar::class) ->setArguments([ 'foo' => $container->getParameter('foo'), 'baz' => $container->getParameter('bar.baz') ]); $bar = $container->get('bar'); var_dump($bar->foo); // hello var_dump($bar->bar); // world
Work with Service Tags
$container->register('foo')->addTag('my.tag', array('hello' => 'world')); $serviceIds = $container->findTaggedServiceIds('my.tag'); foreach ($serviceIds as $serviceId => $tags) { foreach ($tags as $tag) { echo $tag['hello']; } }
License
The MIT license. See MIT