https://github.com/usmanhalalit/viocon

A simple and flexible Dependency Injection or Service container for PHP.
https://github.com/usmanhalalit/viocon

Last synced: about 5 hours ago
JSON representation

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

• Host: GitHub
• URL: https://github.com/usmanhalalit/viocon
• Owner: usmanhalalit
• License: mit
• Created: 2013-06-24T17:39:02.000Z (over 11 years ago)
• Default Branch: master
• Last Pushed: 2013-07-13T19:59:53.000Z (over 11 years ago)
• Last Synced: 2024-10-29T07:21:25.065Z (8 days ago)
• Language: PHP
• Homepage:
• Size: 152 KB
• Stars: 4
• Watchers: 5
• Forks: 3
• Open Issues: 1
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
# Viocon [![Build Status](https://travis-ci.org/usmanhalalit/viocon.png?branch=master)](https://travis-ci.org/usmanhalalit/viocon)

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](http://getcomposer.org/) 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](https://packagist.org/packages/usmanhalalit/viocon).

## Usage

```PHP

$container = new \Viocon\Container();

```

**You can optionally create a class alias too**

```PHP

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

```PHP

\Container::set(...);

\Container::build(...);

```

And so ...

___

### Bind a closure

```PHP

$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

```PHP

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

```

### Singleton

```PHP

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

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

```

### Replacing Objects at Runtime

It can be useful while testing with mocked object

```PHP

$mockedClass = new \stdClass();

$mockedClass->testVar = 'mocked';

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

$stdClass = static::$container->build('\\stdClass');

$this->assertEquals('mocked', $stdClass->testVar);

```