smoothphp / querybus
A simple bus for queries
Installs: 80 182
Dependents: 0
Suggesters: 0
Security: 0
Stars: 10
Watchers: 2
Forks: 3
Open Issues: 0
Requires
- php: >=7.0.0
Requires (Dev)
- laravel/laravel: ^5.4.0
- phpunit/phpunit: 4.*
- scrutinizer/ocular: ~1.1
- squizlabs/php_codesniffer: ~2.3
This package is auto-updated.
Last update: 2024-12-12 05:14:39 UTC
README
Install
Via Composer
$ composer require smoothphp/querybus
Usage
The query bus exists to execute queries within the domain of the application. Typically these are read only commands, with write operations being performed using the Command Bus.
The QueryBus is a simple concept, and leaves the majority of the implementation decisions to the developer. A simple implementation is provided for Laravel users.
The query bus exists of 3 components.
- Query
The DTO containing the intent and parameters for the query. - Query Bus
Takes a query object, resolves the query handler, and executes it. - Query Translator
Takes a query, and translates to the query handler class name.
Laravel Users
The Laravel Query bus takes a Query object, and resolves the handler by adding 'Handler' to the class name. This handler class is then resolved by the container and all dependencies are injected.
For example, App\Queries\FindUserById
is resolved to App\Queries\FindUserByIdHandler
, and the handle
method is executed.
You are free to implement query handler resolution however you like, though.
Service Provider
<?php return [ // ... 'providers' => [ // ... SmoothPhp\QueryBus\Laravel\LaravelQueryBusServiceProvider::class, ], ];
Query
<?php class FindUserById { public $id; public function __construct(string $id) { $this->id = $id; } }
Query Handler
<?php class FindUserByIdHandler { private $client; public function __construct(DBClient $client) { $this->client = $client; } public function handle(FindUserById $query) { return $this->client->table('users')->where('id', $query->id)->get(); } }
Using
<?php class ExampleController extends Controller { private $bus; public function __construct(\SmoothPhp\QueryBus\QueryBus $queryBus) { $this->bus = $queryBus; } public function showUser(string $userId) { return view('users.show')->with('user', $this->bus->query(new FindUserById($userId))); } }
Change log
Please see CHANGELOG for more information what has changed recently.
Testing
$ composer test
Contributing
Please see CONTRIBUTING and CONDUCT for details.
Security
If you discover any security related issues, please email simon@smoothphp.com instead of using the issue tracker.
Credits
License
The MIT License (MIT). Please see License File for more information.