meta-tech/silex-controller-service

Controller service provider for Silex2.

MetaTech Silex ControllerServiceProvider

A service provider for Silex for managing DI and mounting on controllers., _(*1)

Requirements

PHP 7.0, _(*2)

Install

The package can be installed using Composer ., _(*3)

composer require meta-tech/silex-controller-service

Or add the package to your composer.json., _(*4)

"require": {
    "meta-tech/silex-controller-service" : "~1.0"
}

Usage

The provider will create a service relative to a Controller instance builded with its dependencies.
If the controller implements the Silex\Api\ControllerProviderInterface the provider will also mount the controller 's routes to the defined routing entry point, _(*5)

Example

Admit you have a controller Test with dependencies on instanciation :, _(*6)

class Test implements ControllerProviderInterface
{
    public function __construct(Application $app, string $foo)
    {
        // do stuff
    }

You can use the ControllerServiceProvider to create a service to manage your controller class instanciation :, _(*7)

use MetaTech\Silex\Provider\ControllerServiceProvider;
use Acme\Ctrl\Test;
...

$app->register(new ControllerServiceProvider(Test::class, [$app, 'foo'], '/test', 'ctrl.'));

first parameter is your controller class
second parameter is an array of your controller dependencies (default [])
third parameter define your controller routing entry point (default null : disabling mounting controller's routes)
fourth parameter define your service 's namespace to access your controller (default 'ctrl.'), _(*8)

The name of the registering service is the given namespace followed by your controller class shortname, _(*9)

With the previous example $app['ctrl.Test'] is now available and return your controller instance., _(*10)

the connect method of your controller can now benefits of this service to define appropriate routes, like that :, _(*11)

class Test implements ControllerProviderInterface
{
    ...

    public function connect(Application $app)
    {
        $collection = $app['controllers_factory'];
        $_          = 'ctrl.Test';

        $collection->match('/'    , "$_:index");
        $collection->match('/test', "$_:test");

        return $collection;
    }
}

Controller 's routes are mount on the defined routing entry point (third parameter);, _(*12)

see source code of MetaTech\Silex\Ws\Controller in meta-tech\silex-core for an advance controller architecture., _(*13)

License

The project is released under the MIT license, see the LICENSE file., _(*14)