artoodetoo/container

Yet another service container

Container

Yet another service container, _(*1)

Container DOES NOT use reflection and type hint information in any form., _(*2)

Features

Container keep two kind of values: services and parameters., _(*3)

Service will instantiated when you call call it by name. Usually service is object type, but not nesessary. Mind it as "product" of some routine., _(*4)

Methods: get() and set()., _(*5)

Parameters are not instantiating, they just stored and retrieved., _(*6)

Methods: getParameter() and setParameter()., _(*7)

Install

To install with composer:, _(*8)

composer require artoodetoo/container

Basic Usage

Configuration

There are special configuraton sections:, _(*9)

• root used to store basic values, which can be substituted into service definition.
• shared node defines shared services. after it created once it can be retrieved many times.
• multiple node defines new instance created on every get() call

In other sections you can store any kind of information and retrieve it in dot notation (see below)., _(*10)

Simple service definition

use R2\DependencyInjection\Container;

$config = [
  'shared' => [
    'view' => R2\Templating\Dirk::class
  ]
];
$c = new Container($config);
$c->get('view')->render('index');

Parameters substitution

$config = [
  'ROOT'   => '\var\www\mysite',
  'PUBLIC' => '\var\www\mysite\public',
  'shared' => [
    'view' => [
      'class' => R2\Templating\Dirk::class,
      'options' => [
          'views' => '%ROOT%/views',
          'cache' => '%ROOT%/cache',
      ],
      ...
  ]
];
...
$c->get('view')->render('index');

Factory method

$config = [
  'shared' => [
    'userManager' => App\UserManager::class,
    'user' => '@userManager:getCurrentUser',
    ...
  ]
]
...
echo $c->get('user')->username;

Container injection

There are two ways to inject container into service instance:
1. Add interface R2\DependencyInjection\ContainerAwareInterface to service class and define setContainer() method. 2. Substitute container in constructor parameters. It is special name CONTAINER:, _(*11)

$config = [
  'shared' => [
    'example' => [
        'class' => Example::class,
        'container' => '%CONTAINER%',
    ],
  ]
];

Parameters and dot notation:

$config = [
  'options' => [
    'cookie' => [
      'name' => 'the-cookie',
      'domain' => '.example.com'
    ]
];
...
setcookie(
  $c->getParameter('options.cookie.name'),
  $value,
  0,
  '/',
  $c->getParameter('options.cookie.domain')
);

Notes and Limits

Any part of configuration can be read by getParameter, including special sections shared and multiple., _(*12)

As for now, substitution patterns work in service production only., _(*13)

Only parameters from config root can be used in substitution patterns., _(*14)

License

The Container is open-source software, licensed under the MIT license, _(*15)