Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/thiagodp/di
Dependency Injection for PHP
https://github.com/thiagodp/di
dependency-injection injection ioc php phputil
Last synced: 1 day ago
JSON representation
Dependency Injection for PHP
- Host: GitHub
- URL: https://github.com/thiagodp/di
- Owner: thiagodp
- License: lgpl-3.0
- Created: 2015-11-12T14:56:45.000Z (almost 9 years ago)
- Default Branch: master
- Last Pushed: 2018-02-12T23:55:15.000Z (over 6 years ago)
- Last Synced: 2024-10-10T19:07:31.269Z (28 days ago)
- Topics: dependency-injection, injection, ioc, php, phputil
- Language: PHP
- Size: 15.6 KB
- Stars: 6
- Watchers: 5
- Forks: 1
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# di
Dependency Injection for PHP.
[](https://travis-ci.org/thiagodp/di)
We use [semantic version](http://semver.org/). See [our releases](https://github.com/thiagodp/di/releases).
### Classes
* [phputil\DI](https://github.com/thiagodp/di/blob/master/lib/DI.php)
### Installation
```command
composer require phputil/di
```
### Example 1: automatic injection without configuring anything
```php
class A {}
class B {}
class C {
public $a, $b;
function __construct( A $a, B $b ) {
$this->a = $a;
$this->b = $b;
}
}
// Automatically creates "A" and "B", and inject them in "C"
$c = DI::create( 'C' );
```
### Example 2: configuring the injection for interfaces
```php
interface MyInterface {
function say( $what );
}
class MyClass implements MyInterface {
function say( $what ) { echo $what; }
}
// Configures "MyInterface" to be created using "MyClass"
DI::config( DI::let( 'MyInterface' )->create( 'MyClass' ) );
$foo = DI::create( 'MyClass' ); // Create an instance of MyClass (no configuration required)
$foo->say( 'hello' );
$bar = DI::create( 'MyInterface' ); // Create an instance of MyClass!
$bar->say( 'world' );
```
### Example 3: a more complex model
```php
interface I {}
class A {}
class B implements I {}
class C {
public $i;
function __construct( I $i ) {
$this->i = $i;
}
}
class X {
public $a, $c;
function __construct( A $a, C $c ) {
$this->a = $a;
$this->c = $c;
}
}
// Configures "I" to be created using "B"
DI::config( DI::let( 'I' )->create( 'B' ) );
// Automatically creates and injects "A" and "C", and
// when creates "C", also injects "B" as "I".
$x = DI::create( 'X' );
```
### Example 4: passing constructor's arguments
```php
class A {
function __construct( $one, $two = 'world' ) {
echo $one, ', ', $two;
}
}
// Creates "A", passing constructor arguments as an array
$a = DI::create( 'A', array( 'hello' ) ); // prints hello, world
```
### Example 5: configuring shared instances
```php
class A {}
// Makes "A" a shared instance
DI::config( DI::let( 'A' )->shared() );
$a1 = DI::create( 'A' );
$a2 = DI::create( 'A' );
var_dump( $a1 === $a2 ); // bool(true)
```
### Example 6: configuring shared instances for interfaces
```php
interface I {}
class C implements I {}
// Makes "I" a shared instance
DI::config( DI::let( 'I' )->create( 'C' )->shared() );
$i1 = DI::create( 'I' );
$i2 = DI::create( 'I' );
var_dump( $i1 === $i2 ); // bool(true)
```
### Example 7: defining a creation function
```php
interface I {}
class C implements I {}
// Let you using a callable to create the desired instance
DI::config( DI::let( 'I' )->call( function() {
return new C();
} ) );
$i = DI::create( 'I' ); // Calls your function to create a "C" instance
```
### Example 8: passing arguments for creation functions
```php
class A {
private $text;
function __construct( $text ) {
$this->text = $text;
}
}
// Lets you customize a callable with parameters
DI::config( DI::let( 'A' )->call( function( $a, $b ) {
return new A( $a . $b );
} ) );
// Uses the customized constructor
$a = DI::create( 'A', array( 'Hello, ', 'world' ) );
echo $a->text(); // Hello, world
// Ignore the customized constructor passing true after the parameters
$a2 = DI::create( 'A', array( 'Hi!' ), true );
echo $a2->text(); // Hi
```