library tactician-service-provider

hellofresh/tactician-service-provider

Silex tactician service provider

Tactician Service Provider

, _(*1)

Provides Tactician as service to Pimple or Silex Container, _(*2)

Requirements

• PHP >= 5.5
• Silex >= 2.0
• Pimple >= 3.0

Installation

composer require jowy/tactician-service-provider, _(*3)

Usage

Register tactician service provider

$app->register(
    new TacticianServiceProvider(
        [
            'tactician.inflector' => 'class_name',
            'tactician.middleware' =>
                [
                    new LockingMiddleware()
                ]
       ]
   )
);

Register command handler in DIC

Handler must registered in container and use FQCN as service id, _(*4)

$app[HandlerClass::class] = function() {
    return new HandlerClass();
};

Map command and handler

after tactician commadn bus service provider registered, you can map command and handler, _(*5)

$app['tactician.locator']->addHandler(CommandClass::class, HandlerClass:class);

Dispatching Command

$command = new CommandClass('param');

$container['tactician.command_bus']->handle($command)

Options

Inflector

• class_name
• class_name_without_suffix
• handle
• invoke

For more information for choosing Inflector please refer to this documentation, _(*6)

Middleware

Middleware can be added while tactician service registered was registered., _(*7)

$app->register(
    new TacticianServiceProvider(
        [
            'tactician.inflector' => 'class_name',
            'tactician.middleware' =>
                [
                    new LockingMiddleware(),
                    new SomeMiddleware(),
                    new OtherMiddleware()
                ]
        ]
    )
);

Optionally lazy initialization for middleware is possible by using this method, _(*8)

$app[LockingMiddleware::class] = function () {
    return new LockingMiddleware();
};

$app->register(
    new TacticianServiceProvider(
        [
            'tactician.inflector' => 'class_name',
            'tactician.middleware' =>
                [
                    LockingMiddleware::class;
                ]
        ]
    )
);

License

MIT, see LICENSE, _(*9)