chippyash/slim-symfony-dic

Symfony 2 DIC integration for the Slim Framework 3

chippyash/Slim-Symfony-Dic

Quality Assurance

, _(*1)

The above badges represent the current development branch. As a rule, I don't push to GitHub unless tests, coverage and usability are acceptable. This may not be true for short periods of time; on holiday, need code for some other downstream project etc. If you need stable code, use a tagged version. Read 'Installation'., _(*2)

See the tests and the Test Contract for additional information., _(*3)

Please note that developer support for PHP5.5 was withdrawn at version 3.0.0 of this library. If you need support for PHP 5.5, please use a version >=2,<3, _(*4)

What?

Provides a Symfony Dependency Injection Container V2 or Symfony Dependency Injection Container V4 for a Slim Application V3. The DI container depends on the version of PHP you are using. < 7, then V2, >=7.1 then V4, _(*5)

Why?

The Slim framework is great for lightweight sites and in version V3 adopts the interop interfaces for dependency injection containers. Slim V3 uses the Pimple DI by default. Symfony DI does not yet support the interop interface definition., _(*6)

This small library supports the integration of the easy to use, yet powerful Symfony version of a DI container with the lightweight Slim Framework, giving you the ability to create great, maintainable and configurable web sites quickly., _(*7)

The Builder supports XML DI definition. XML is the most powerful and complete form of Symfony DI configuration. The Builder also supports Yaml DI definition. Many developers prefer to put the parameters into a Yaml file and service definitions into an XML file. The supplied minimal example files demonstrate this usage., _(*8)

How?

To create and return a Slim\App object with a Symfony DIC:, _(*9)

use Chippyash\Type\String\StringType;
use Slimdic\Dic\Builder;
use Slim\App;

$xmlDiFileLocation = '/mysite/cfg/dic.production.xml';

/**
 * @var Slim\App
 */
$app = new App(Builder::buildDic(new StringType($xmlDiFileLocation)));

Please see the examples/dic.slim.v2.xml, examples/dic.slim.v3.xml and examples/dic.slim.yml files for the minimum that you need to build the DIC with to support Slim. You are recommended to put the files in with the rest of your DI configs and use the <imports> directive in your main config to pull it in., _(*10)

You can add to the compilation process by utilising the pre and post compile functions. This is often useful for setting up synthetic services or initialising parameters in the DI container., _(*11)

Register a PreCompile function

The PreCompile function is called just before the container is compiled., _(*12)

use Slimdic\Dic\ServiceContainer;
use Symfony\Component\DependencyInjection\Definition;

Builder::registerPreCompileFunction(function($dic) {
    //set a parameter
    $dic->setParameter('foo', 'bar');
    //set up a synthetic
    $dic->setDefinition('bar', (new Definition())->setSynthetic(true));
});

$app = new App(Builder::buildDic(new StringType($xmlDiFileLocation)));

Register a PostCompile function

The PostCompile function is called just after compiling the container., _(*13)

The post compile function only really makes sense to set a synthetic definition as after compilation the rest of the DI Container is frozen and cannot be changed., _(*14)

use Slimdic\Dic\ServiceContainer;

Builder::registerPreCompileFunction(function($dic) {
    $dic->setDefinition('foo', (new Definition())->setSynthetic(true));
});

Builder::registerPostCompileFunction(function($dic, $stage) {
    $dic->set('foo', $myFooService);
});

Changing the library

1. fork it
2. write the test
3. amend it
4. do a pull request

Found a bug you can't figure out?, _(*15)

1. fork it
2. write the test
3. do a pull request

or raise an issue ticket, _(*16)

NB. Make sure you rebase to HEAD before your pull request, _(*17)

Where?

The library is hosted at Github. It is available at Packagist.org, _(*18)

Check out ZF4 Packages for more packages, _(*19)

See My blog for ramblings on coding and curries, _(*20)

Installation

Install Composer, _(*21)

For production

    "chippyash/slim-symfony-dic": ">=3,

to your composer.json "requires" section

#### For development

Clone this repo, and then run Composer in local repo root to pull in dependencies

    git clone git@github.com:chippyash/Slim-Symfony-Dic.git Slimdic
    cd Slimdic
    composer install --dev

To run the tests:, (*22)
    cd Slimdic
    vendor/bin/phpunit -c test/phpunit.xml test/
License
This software library is released under the BSD 3 Clause license, (*23)

This software library is Copyright (c) 2016-2018, Ashley Kitson, UK, (*24)
History
V1.0.0 Initial Release, (*25)


V1.1.0 Update dependencies, (*26)

V1.1.1 Add link to packages, (*27)

V1.1.2 Verify PHP 7 compatibilty, (*28)

V1.1.3 Update Slim dependency to 3.*, (*29)

V1.1.4 Update dependencies, (*30)


V1.1.5 Update build script, (*31)

V2.0.0 PHP 7.0 support withdrawn, updated to use 7.1, primarily because of underlaying 
libraries that don't support 7.0, (*32)

V2.0.2 Fix unit tests to run under PHP 7.1, (*33)

V3.0.0 BC Break.  Withdraw support for PHP <5.6, (*34)

V3.1.0 Change of license from GPL V3 to BSD 3 Clause, (*35)


V3.1.1 dependency update, (*36)