wscore/dicontainer

Simple DI container with auto-wiring.

WScore.DiContainer

A simple Dependency Injection Container., _(*1)

Usage

Creating an instance

Use instance scripts, _(*2)

$container = include( 'WScore.DiContainer/scripts/instance.php' );

Setting and retrieving values.

Set and retrieve a value., _(*3)

$container->set( 'some-id', 'a value' );
$value = $container->get( 'some-id' ); // gets a string: "a value".

Set a service object., _(*4)

$container->set( 'service-this', '\name\space\className' );
$object = $container->get( 'service-this' ); // it's \name\space\className class.

Or, simply specify a class name to get an object., _(*5)

$object = $container->get( '\name\space\className2' );

Getting another class

Set another class for a given class., _(*6)

$container->set( '\some\class', '\name\space\className' );
$object = $container->get( '\some\class' ); // it's \name\space\className class.

Auto-Wiring/Discovery

Supports simple auto-wiring or auto-discovery of dependencies using annotations in phpdocs. The supported tags are: @Inject, @param, and @var., _(*7)

The @Singleton annotation is also supported., _(*8)

Sample PHP class code:, _(*9)

/**
 * @Singleton
 */
class Sample {
    /**
     * @Inject
     * @var /class/class
     */
    private $property;

    /**
     * @Inject
     * @param /some/class1 $var
     * @param /some/class2 $var2
     */
    function __construct( $var, $var2 ) {}

    /**
     * @Inject
     * @param /some/class1 $var3
     */
    function setVar3( $var3 ) {}
}

Overwriting DI Option

The container can overwrite the dependency of any of the injection types: construct, setter, and property injections. Specify the option at get,, _(*10)

$container->option( 'Some\Class' )
    ->setConstructor( 'var', 'another\class' )
    ->setSetter( 'setVar3', 'setter\class', )
    ->setProperty( 'property', 'property\class' );
$object = $container->get( 'Some\Class );