README

A simple and flexible Dependency Injection or Service container for PHP.

It can be extremely helpful to decouple your dependencies. You can also mock dependencies at runtime.

Installation

Viocon uses Composer to make things easy.

Learn to use composer and add this to require (in your composer.json):

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

Library on Packagist.

Usage

$container = new \Viocon\Container();

You can optionally create a class alias too

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

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

And so ...

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

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

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

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