usmanhalalit/viocon

A simple and flexible Dependency Injection container for PHP.

Viocon

A simple and flexible Dependency Injection or Service container for PHP., _(*1)

It can be extremely helpful to decouple your dependencies. You can also mock dependencies at runtime., _(*2)

Installation

Viocon uses Composer to make things easy., _(*3)

Learn to use composer and add this to require (in your composer.json):, _(*4)

"usmanhalalit/viocon": "1.0.*@dev"

Library on Packagist., _(*5)

Usage

$container = new \Viocon\Container();

You can optionally create a class alias too, _(*6)

new \Viocon\Container('Container');

Viocon will create a class alias for you with the given name 'Container'. Now you can use this class' methods statically, like, _(*7)

\Container::set(...);
\Container::build(...);

And so ..., _(*8)

Bind a closure

$container->set('myClosure', function ($test1, $test2) 
{
    $stdClass = new \stdClass();
    $stdClass->testVar1 = $test1;
    $stdClass->testVar2 = $test2;
    $stdClass->testMethod = function ($test3) {
        return $test3;
    };

    return $stdClass;
});

$object = $container->build('myClosure', array('Test Var 1', 'Test Var 2'))

echo $object->testVar1;

Build Any Class and Optionally Pass Parameters

$container->build('\PDO', array('myConnectionInfo'));

Singleton

$container->set('mySingleton', '\\stdClass');
$stdClass = $container->build('mySingleton');

Replacing Objects at Runtime

It can be useful while testing with mocked object, _(*9)

$mockedClass = new \stdClass();
$mockedClass->testVar = 'mocked';

static::$container->setInstance('\\stdClass', $mockedClass);

$stdClass = static::$container->build('\\stdClass');
$this->assertEquals('mocked', $stdClass->testVar);