spekkionu/tactician-container-selfhandling

Container-Aware Self-Handling commands for Tactician Command Bus

Tactician Container-Aware Self-Handling Commands

, _(*1)

Install

Via Composer, _(*2)

``` bash $ composer require spekkionu/tactician-container-selfhandling, <sub>(*3)</sub>

If you want to use the container aware commands you will also need to install `league/container`

## Usage

### Add MiddleWare

``` php
use League\Tactician\CommandBus;
use Spekkionu\Tactician\SelfExecuting\SelfExecutionMiddleware;

$commandBus = new CommandBus([
    // any other pre-execution middleware
    new SelfExecutionMiddleware(),
    // other middleware to handle non-self-executing commands
    // any other post-execution middleware
]);

Create a Command

Your commands must implement Spekkionu\Tactician\SelfExecuting\SelfExecutingCommand and have a handle() method., <sub>(*4)</sub>

The handle method must have no parameters., <sub>(*5)</sub>

``` php use Spekkionu\Tactician\SelfExecuting\SelfExecutingCommand;, <sub>(*6)</sub>

/** * Class ExampleSelfExecutingCommand */ class ExampleSelfExecutingCommand implements SelfExecutingCommand { /** * @return string */ public function handle() { // do work here } }, <sub>(*7)</sub>

### Run Command

``` php
$commandBus->handle(new ExampleSelfExecutingCommand());

Container-Aware Self-Executing Commands

Container aware commands will have dependencies injected into the handle() method from league/container., <sub>(*8)</sub>

``` php use League\Container\Container; use League\Tactician\CommandBus; use Spekkionu\Tactician\SelfExecuting\SelfExecutionMiddleware;, <sub>(*9)</sub>

// Setup the Container $container = new Container(); $container->delegate( new \League\Container\ReflectionContainer ); $container->add('Logger', function() { return new Logger(); });, <sub>(*10)</sub>

// Setup the command bus $commandBus = new CommandBus([ // any other pre-execution middleware new ContainerAwareSelfExecutionMiddleware($container), // other middleware to handle non-self-executing commands // any other post-execution middleware ]);, <sub>(*11)</sub>

``` php
use Spekkionu\Tactician\SelfExecuting\SelfExecutingCommand;

/**
 * Class ExampleSelfExecutingCommand
 */
class ExampleSelfExecutingCommand implements SelfExecutingCommand
{
    /**
     * The logger will be injected automatically
     * @return string
     */
    public function handle(Logger $logger)
    {
        $logger->log('log message');
    }
}

``` php $commandBus->handle(new ExampleSelfExecutingCommand());, <sub>(*12)</sub>

## Testing

``` bash
$ composer test

License

The MIT License (MIT). Please see License File for more information., <sub>(*13)</sub>