chimera/foundation

Base structure to connect PSR-7 objects to command and query buses

0.4.0 2021-02-23 20:58 UTC

Requires

• php: ^7.4 || ^8.0
• ramsey/uuid: ^4.1

Requires (Dev)

• infection/infection: ^0.21
• lcobucci/coding-standard: ^6.0
• phpstan/extension-installer: ^1.1
• phpstan/phpstan: ^0.12
• phpstan/phpstan-deprecation-rules: ^0.12
• phpstan/phpstan-phpunit: ^0.12
• phpstan/phpstan-strict-rules: ^0.12
• phpunit/phpunit: ^9.5

MIT

• Luís Cobucci

README

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 particular package provides abstractions and default components to standardise some basic concepts, creating a foundation to connect different libraries together without creating a huge monster.

Installation

You probably won't depend directly on this package, but it is available on Packagist, and can be installed using Composer:

$ composer require chimera/foundation

PHP Configuration

In 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

Related packages

• chimera/bus-tactician: Adapter for the amazing league/tactician
• chimera/routing: Abstractions and reusable request handlers (controllers) to handle HTTP requests
• chimera/routing-expressive: Adapter for the great zendframework/zend-expressive
• chimera/serialization-jms: Adapter for the really flexible jms/serializer
• chimera/di-symfony: A set of compiler passes that plugs everything together while compiling the container, so that no unnecessary process is executed when the software is handling user requests
• chimera/sample: A very basic application showing how to use this set of libraries
• chimera/sample-react: A very basic application showing how to use this set of libraries (using ReactPHP)

License

MIT, see LICENSE.