flexsounds/slim-container-builder

A light weight container builder from a configuration file

, _(*1)

Slim-Container-Builder

A tool to build your Slim Framework 3 container. Instead of having to define your container in php, you just define it from a configuration file., _(*2)

This will not replace the pimple container, but will build one for you., _(*3)

Installation

User composer to install, _(*4)

composer require flexsounds/slim-container-builder

Install symfony/yaml to use yaml files!, _(*5)

Default usage

This will create a slim framework container with your services defined in a configuration file., _(*6)

$containerBuilder = new \Flexsounds\Slim\ContainerBuilder\ContainerBuilder();
$containerBuilder->setLoader($loader = new \Flexsounds\Slim\ContainerBuilder\Loader\FileLoader('./config'));
$loader->addFile("config.yml");
$app = new Slim\App($containerBuilder->getContainer());

// define your routes here.

$app->run();

Configuration file support

We use hassankhan/config to load the configuration, which has support for YML, XML, JSON and some more., _(*7)

You can import other configuration files from a configuration file, independent of what file format., _(*8)

# config.yml
imports:
  - { Resource: otherconfig.xml }

All examples are created in yaml notation!, _(*9)

Creating your services

The service configuration has almost the same notation as Symfony does. Which means you could copy your service configuration you built to a Symfony application (keep in mind, symfony has many more features than Slim Container Builder), _(*10)

All your services must be defined under the services key and are shared throughout your entire application. The default services like settings, request, response, router etc. from Slim Framework are also available as service, _(*11)

Basic example

Creating a service without any arguments is very simple., _(*12)

services:
  my.custom.service:
    class: 'App\MyBasicService'

In your code you can use, _(*13)

$app->get('/', function($request, $response){
    $myCustomService = $this->get('my.custom.service');
    // $myCustomService is now an instance of 'App\MyBasicService'
});

Non-Shared services

All services are shared by default. Which means each time you retrieve the service, you get the same instance. When you want a new instance each time you call the service, use the shared key, _(*14)

services:
    my.nonshared.service:
        class: 'App\MyNonSharedService'
        shared: false

Dependency Injection

Some of your services might need some dependency injection, this could be done with the arguments key. You can inject anyting you want, even other services., _(*15)

services:
  mailer:
    class: 'Location\To\Mailer'


  newslettermanager:
    class: 'App\Newsletter\NewsletterManager'
    arguments:
      - '@mailer'

namespace App\Newsletter;

use Location\To\Mailer;

class NewsletterManager {

    public function __construct(Mailer $mailer)
    {
        $this->mailer = $mailer;
    }
}

Contributing

Read the CONTRIBUTING for details, _(*16)