willdurand/stack-negotiation

Stack middleware for content negotiation.

StackNegotiation

, _(*1)

Stack middleware for content negotiation., _(*2)

Installation

The recommended way to install StackNegotiation is through Composer:, _(*3)

``` bash $ composer require "willdurand/stack-negotiation", <sub>(*4)</sub>

Usage
-----

```php
use Negotiation\Stack\Negotiation;

$app = new Negotiation($app);

Headers

Accept Header

This middleware adds a _accept attribute to the request, containing a AcceptHeader object (see: Negotiation library). It also adds a _mime_type attribute containing the mime type if it is not a media range, as well as a _format attribute containing the preferred format value., <sub>(*5)</sub>

Accept-Language Header

This middleware adds a _accept_language attribute to the request, containing a AcceptHeader object (see: Negotiation library). It also adds a _language attribute containing the value itself., <sub>(*6)</sub>

Content-Type Header

This middleware is able to decode a request body, and fill in request data. It is inspired by Silex's recipe Accepting a JSON Request Body and FOSRestBundle Body Listener., <sub>(*7)</sub>

Options

You can pass an array of options to the middleware:, <sub>(*8)</sub>

$app = new Negotiation($app, null, null, null, [
    'language_priorities' => [ '... '],
    'format_priorities'   => [ '... '],
]);

Unit Tests

Setup the test suite using Composer:, <sub>(*9)</sub>

$ composer install --dev

Run it using PHPUnit:, <sub>(*10)</sub>

$ ./vendor/bin/phpunit

Contributing

See CONTRIBUTING file., <sub>(*11)</sub>

License

StackNegotiation is released under the MIT License. See the bundled LICENSE file for details., <sub>(*12)</sub>