https://github.com/polylang/polylang-di
Dependency Injection Container by WP Syntex (Polylang).
https://github.com/polylang/polylang-di
Last synced: 5 months ago
JSON representation
Dependency Injection Container by WP Syntex (Polylang).
- Host: GitHub
- URL: https://github.com/polylang/polylang-di
- Owner: polylang
- License: gpl-3.0
- Created: 2022-03-25T16:49:38.000Z (over 4 years ago)
- Default Branch: main
- Last Pushed: 2022-04-11T09:48:27.000Z (about 4 years ago)
- Last Synced: 2025-10-21T11:48:26.319Z (8 months ago)
- Language: PHP
- Size: 42 KB
- Stars: 0
- Watchers: 2
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Polylang DI
[](https://packagist.org/packages/wpsyntex/polylang-di)
[](LICENSE.md)
Dependency Injection Container by WP Syntex (Polylang).
This package is compliant with [PSR-4](https://www.php-fig.org/psr/psr-4/) and [PSR-11](https://www.php-fig.org/psr/psr-11/).
However, PSR-11's interfaces are not implemented, to prevent conflicts with other plugins and themes that may use a different version of them.
This project is pretty much a fork of an old version of [league/container](https://github.com/thephpleague/container), that has been reworked a bit to keep only the features that we need in our projects.
## Install
Via Composer
``` bash
composer require wpsyntex/polylang-di
```
## Requirements
This package supports php 5.6+.
## Documentation
### Create and retrieve shared and not shared instances
```php
add( 'foo', 'Foobar\Foo' );
// Instanciate and retrieve.
$foo1 = $container->get( 'foo' );
$foo2 = $container->get( 'foo' );
// We created 2 different instances.
var_dump( $foo1 === $foo2 ); // False.
// Add to the container as a shared item.
$container->addShared( 'foo', 'Foobar\Foo' );
// Instanciate and retrieve.
$foo1 = $container->get( 'foo' );
$foo2 = $container->get( 'foo' );
// We created only one instance.
var_dump( $foo1 === $foo2 ); // True.
```
### Add arguments
```php
int = $int;
$this->string = $string;
}
}
$container = new \WP_Syntex\Polylang_DI\Container();
// Add to the container.
$container->add( 'foo', Foo::class )
->withArgument( 46 );
// Instanciate and retrieve.
$foo1 = $container->get( 'foo' );
$foo2 = $container->get( 'foo' );
// We created 2 different instances with the same arguments.
var_dump( $foo1 === $foo2 ); // False.
var_dump( $foo1->int ); // 46.
var_dump( $foo1->string ); // Null.
var_dump( $foo1->int === $foo2->int ); // True.
var_dump( $foo1->string === $foo2->string ); // True.
// Retrieve the definition and add an argument.
$container->extend( 'foo' )
->withArgument( 'a string' ); // Not not shared items only.
// Instanciate and retrieve.
$foo3 = $container->get( 'foo' );
var_dump( $foo3->int ); // 46.
var_dump( $foo3->string ); // 'a string'.
// Retrieve the definition and replace previous arguments.
$container->extend( 'foo' )
->withNewArguments(
[
22,
'some string',
]
);
$foo4 = $container->get( 'foo' );
var_dump( $foo4->int ); // 22.
var_dump( $foo4->string ); // 'some string'.
// With an anonymous function.
$container->add( 'prefix', 'String prefix' );
$container->add(
'foo',
function ( $container, $int, $string ) {
$prefix = $container->get( 'prefix' );
return new Foo( $int, $prefix . ' - ' . $string );
}
)
->withArguments(
[
32,
'another string',
]
);
$foo5 = $container->get( 'foo' );
var_dump( $foo5->int ); // 32.
var_dump( $foo5->string ); // 'String prefix - another string'.
```
### Reference other items (or not)
```php
foo = $foo;
$this->string = $string;
}
}
$container = new \WP_Syntex\Polylang_DI\Container();
// Add to the container.
$container->addShared( 'foo', Foo::class );
$container->add( 'bar', Bar::class )
->withArgument( 'foo' ) // Same identifier used for Foobar\Foo.
->withArgument(
new \WP_Syntex\Polylang_DI\Argument\RawArgument( 'foo' ) // Same identifier used for Foobar\Foo, but we just want to pass a string here.
);
// Instanciate and retrieve.
$bar1 = $container->get( 'bar' );
$bar2 = $container->get( 'bar' );
// We created 2 different instances with the same arguments.
var_dump( $bar1 === $bar2 ); // False.
var_dump( $bar1->foo instanceof Foo ); // True.
var_dump( $bar1->foo === $bar2->foo ); // True.
var_dump( $bar1->string ); // 'foo'.
```