league/tactician-doctrine

Plugins for Tactician commands using Doctrine, like wrapping every command in a transaction

tactician-doctrine

, _(*1)

This package adds plugins for using Tactician with Doctrine components, either the ORM or just DBAL. The main feature is the ability to wrap each command in a separate database transaction., _(*2)

Setup

Via Composer, _(*3)

``` bash $ composer require league/tactician-doctrine, <sub>(*4)</sub>

Next, add the `ORM\TransactionMiddleware` to your CommandBus:

``` php
$commandBus = new \League\Tactician\CommandBus(
    [
        new TransactionMiddleware($ormEntityManager)
    ]
);

That's it. Each command you execute will now open and close a new transaction., <sub>(*5)</sub>

If a command fires off more commands, be aware that those commands will run in the same transaction as the parent. It is recommended that you run each command as a separate transaction, so to prevent this from happening, use the LockingMiddleware that ships in Tactician core. This will queue the commands up internally until the parent command has completed., <sub>(*6)</sub>

If an exception is raised while handling the command, the transaction is rolled back, the EntityManager closed, and the exception rethrown., <sub>(*7)</sub>

Symfony integration

When using the [tactician-bundle] (https://github.com/thephpleague/tactician-bundle), don't forget to add the Doctrine middleware to your Symfony config:, <sub>(*8)</sub>

tactician:
    commandbus:
        default:
            middleware:
             - tactician.middleware.locking
             - tactician.middleware.doctrine
             - tactician.middleware.command_handler

Testing

bash $ ./vendor/bin/phpunit, <sub>(*9)</sub>

Security

Disclosure information can be found on the main Tactician repo., <sub>(*10)</sub>

License

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