acne/acne

Simple DI Container for PHP < 5.3

Acne

Acne is simple DI Container for PHP < 5.2, _(*1)

Heavily inspired by fabpot/Pimple, _(*2)

Usage

Defining parameters

You can use Acne_Container like an associative array., _(*3)

Just set value with key., _(*4)

<?php
$container = new Acne_Container;

$container['session.cookie_name'] = 'PHPSESSID';

Defining service providers

Service provider is factory which constructs an object., _(*5)

Closure can be a service provider and it is the most prefferable way for PHP >= 5.3, _(*6)

<?php
$container['session'] = function ($c) {
    return new Session($c['session.cookie_name']);
};
$container['session.cookie_name'] = 'PHPSESSID';

But if you're using PHP < 5.3, you can't use Closure., _(*7)

This is why I create Acne., _(*8)

Also the other callable values can be set as service provider.
But notice that string can't be a service provider., _(*9)

<?php
class ServiceProviderCollection
{
    public function provideSession($c)
    {
        return new Session($c['session.cookie_name']);
    }
}

$providerCollection = new ServiceProviderCollection;

$container['session'] = array($providerCollection, 'provideSession');
$container['session.cookie_name'] = 'PHPSESSID';

Getting object from container

After you defined service provider, you can get object which the provider constructed., _(*10)

<?php
$session = $container['session'];
$name = $session->get('name');

Defining shared service providers

If you want to share objects like Singleton pattern, you can use shared service provider., _(*11)

Shared service provider constructs object only once., _(*12)

<?php
$container->share('session', function ($c) {
    return new Session($c['session.cookie_name']);
});

Pimple-like way is also available., _(*13)

<?php
$container['session'] = $container->share(function ($c) {
    return new Session($c['session.cookie_name']);
});

Author

Yuya Takeyama, _(*14)