madewithlove / tactician-laravel
Integrate tactician with Laravel 5
Installs: 61 919
Dependents: 0
Suggesters: 1
Security: 0
Stars: 20
Watchers: 10
Forks: 4
Open Issues: 1
Requires
- php: >=7.2
- illuminate/container: ^5.0|^6.0|^7.0
- illuminate/database: ^5.0|^6.0|^7.0
- illuminate/support: ^5.0|^6.0|^7.0
- league/tactician: ^1.0
Requires (Dev)
- friendsofphp/php-cs-fixer: ^2.15
- madewithlove/php-cs-fixer-config: ^1.10
- mockery/mockery: ^0.9.4
- phpunit/phpunit: ^8.3
This package is auto-updated.
Last update: 2020-01-11 18:03:27 UTC
README
Introduction
This packages is a replacement for Laravel 5's default command bus using tactician.
Default middleware
- LockingMiddleware (block commands from running inside commands)
- TransactionMiddleware (Run all commands in a database transaction and rolls back incase of failure)
Command Handling
By default commands will be resolved as followed:
Acme\Jobs\Foo => Acme\Listeners\Foo
Acme\Foo\Jobs\Bar => Acme\Foo\Listeners\Bar
All command handlers are resolved out of the container which mean you can use all kind of Laravel goodies.
Install
$ composer require madewithlove/tactician-laravel
Laravel <= 5.4
Add the service provider to config/app.php
:
Madewithlove\Tactician\ServiceProvider::class,
In case you want to tweak the middleware you should publish the package configuration:
php artisan vendor:publish --provider="Madewithlove\Tactician\ServiceProvider"
Usage
Writing commands
A command always consists out of two parts: the command and the handler.
// Products\Jobs\CalculatePriceForQuantity class CalculatePriceForQuantity { public $price; public $amount; public function __construct($price, $amount = 1) { $this->price = $price; $this->amount = $amount; } } use Products\Jobs\CalculatePriceForQuantity as Job; // Products\Listeners\CalculatePriceForQuantity class CalculatePriceForQuantity { public function handle(Job $job) { return $job->amount * $job->price; } }
Overriding the command handling logic
If you're not happy with the default logic shipped in this package you can overwrite it easily by
rebinding the League\Tactician\Handler\CommandHandlerMiddleware
. You do this by adding the following to your
application's service provider, refer to Tactician's documentation
for options.
public function register() { $this->app->bind(CommandHandlerMiddleware::class, function () { // Return your own implementation of CommandHandlerMiddleware here. }); }
Middleware
This package includes a couple middleware specific to Laravel, you can choose to use these.
TransactionMiddleware
This middleware is included by default. It means all your commands are handled inside of a database transaction, and if an error occurs it will rollback the transaction.
It's quite common for a command to throw an exception that is caught higher up the chain so a certain action can be performed
(such as displaying an error message) but still perform some kind of database interaction. For cases such as this you can make use of
the Madewithlove\Tactician\Contracts\IgnoresRollback
interface. Simply implement it on your exception and no rollbacks will be performed!
Note: This middleware only runs the main database connection in a transaction, if you use multiple connections you will need to come up with a custom solution.
Testing
$ composer test
License
The MIT License (MIT). Please see License File for more information.