The term Chimera (/kɪˈmɪərə/ or /kaɪˈmɪərə/) has come to describe any mythical or fictional animal with parts taken from various animals, or to describe anything composed of very disparate parts, or perceived as wildly imaginative, implausible, or dazzling.
There are many many amazing libraries in the PHP community and with the creation and adoption of the PSRs we don't necessarily need to rely on full stack frameworks to create a complex and well designed software. Choosing which components to use and plugging them together can sometimes be a little challenging.
The goal of this set of packages is to make it easier to do that (without compromising the quality), allowing you to focus on the behaviour of your software.
This package provides a set of annotations to be used to configured your command/query handlers, HTTP middleware, and command/query bus middleware.
Important: these annotations will only be used when used together with
packages that read them, like chimera/di-symfony.
Package is available on Packagist, you can install it using Composer.
composer require chimera/mappingIn order to make sure that we're dealing with the correct data, we're using assert(),
which is a very interesting feature in PHP but not often used. The nice thing
about assert() is that we can (and should) disable it in production mode so
that we don't have useless statements.
So, for production mode, we recommend you to set zend.assertions to -1 in your php.ini.
For development you should leave zend.assertions as 1 and set assert.exception to 1, which
will make PHP throw an AssertionError
when things go wrong.
Check the documentation for more information: https://secure.php.net/manual/en/function.assert.php
These are the annotations related to how services should be mapped to the command/query bus:
Chimera\Mapping\ServiceBus\CommandHandler: exposes the class as a command handlerChimera\Mapping\ServiceBus\QueryHandler: exposes the class as a query handlerChimera\Mapping\ServiceBus\Middleware: exposes the class as a command/query middleware
And these are the ones related to how services should be mapped to the PSR-15 application:
Chimera\Mapping\Routing\CreateAndFetchEndpoint: adds an endpoint that will execute a command to create a resource and then a query to fetch its stateChimera\Mapping\Routing\CreateEndpoint: adds an endpoint that will execute a command to create a resourceChimera\Mapping\Routing\ExecuteAndFetchEndpoint: adds an endpoint that will execute a command to modify a resource and then a query to fetch its stateChimera\Mapping\Routing\ExecuteEndpoint: adds an endpoint that will execute a command to modify/remove a resourceChimera\Mapping\Routing\FetchEndpoint: adds an endpoint that will execute a queryChimera\Mapping\Routing\Middleware: exposes the class as a PSR-15 HTTP middleware
The idea of the annotations is to simplify the mapping of services, removing complex tags from the dependency injection container file. They should essentially be used like this:
<?php
declare(strict_types=1);
namespace MyApi\Creation;
use Chimera\Mapping as Chimera;
/**
* @Chimera\Routing\CreateEndpoint(path="/books", command=AddToCollection::class, name="book.create", redirectTo="book.fetch_one")
* @Chimera\ServiceBus\CommandHandler(handles=AddToCollection::class)
*/
final class AddToCollectionHandler
{
// ...
}MIT, see LICENSE.