chimera/routing-mezzio

Laminas Mezzio implementation for chimera/routing

Fund package maintenance!
lcobucci
Patreon

0.4.0 2021-02-24 20:50 UTC

README

Total Downloads Latest Stable Version Unstable Version

Build Status Code Coverage

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 just provides adapters for Laminas Mezzio v3.0, so that it can be used as HTTP application.

Installation

Package is available on Packagist, you can install it using Composer.

composer require chimera/routing-mezzio

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://php.net/assert

Usage

To use this package you need to configured your Laminas Mezzio application to use our packages (as explained here) and register instances of Chimera\Routing\Mezzio\UriGenerator and Chimera\Routing\Mezzio\RouteParamsExtractor in your DI container.

License

MIT, see LICENSE.