ptlis / psr7-conneg
PSR7 content negotiation
Requires
- php: >=5.3.0
- psr/http-message: ~1.0
- ptlis/conneg: ~3.0
Requires (Dev)
- pdepend/pdepend: ~2.0
- phploc/phploc: ~2.0
- phpmd/phpmd: ~2.2
- phpunit/phpunit: ~4.5
- relay/relay: 1.*@dev
- sebastian/phpcpd: ~2.0
- squizlabs/php_codesniffer: ~2.0
- zendframework/zend-diactoros: ~1.0
- zendframework/zend-stratigility: ~1.0
Suggests
- relay/relay: To use the bundled Relay middleware.
- zendframework/zend-stratigility: To use the bundled stratigility middleware.
This package is auto-updated.
Last update: 2024-09-07 00:32:36 UTC
README
A content negotiation middleware that uses the PSR-7 interfaces.
Configurable component that decorate processed requests with preferred type information.
Built upon ptlis/ConNeg.
Install
Either from the console:
$ composer require ptlis/psr7-conneg:~1.2
Or by Editing composer.json:
{ "require": { ... "ptlis/conneg-psr7-conneg": "~1.2", ... } }
Followed by a composer update:
$ composer update
Usage
The package ships with a single class to provide negotiation.
use ptlis\Psr7ConNeg\Negotiator; $negotiator = new Negotiator();
To opt-in to negotiation on a field use the appropriate with*
method (note these methods return a new instance in the manner of the PSR-7 interfaces).
To negotiate the preferred mime-type use the withMime
method, providing it with a list of your application's type preference:
$negotiator = $negotiator->withMime('application/json;q=1.0,text/xml;q=0.7');
With your negotiator configured you can now perform negotiation:
$request = $negotiator->negotiate($request);
This adds attributes to the request containing the preferred type. These can be accessed with the appropriate getters, in the above example of negotiation on the Accept field this looks like:
$mime = $newRequest->getAttribute(Negotiator::MIME_BEST);
If the Accept field of the request contained application/json,text/xml
then the value returned from this lookup would be application/json
.
With Zend-Stratigility
To use the zend-stratigility component, configure your negotiator instance as described above and pass it to the Stratigility negotiator.
$stratigilityNegotiator = new StratigilityNegotiator($negotiator);
To perform negotiation on all routes, add it with an empty route:
$app->pipe('', $stratigilityNegotiator);
For further information please refer to the Stratigility documentation.
With Relay
To use the relay component, configure your negotiator instance as described above and pass it to the Relay negotiator.
$queue[] = new RelayNegotiator($negotiator);
Note: The negotiator must be earlier in the queue than middleware components that depend upon negotiation data.
Integration
Middlewares integration is shipped for the following packages:
Contributing
You can contribute by submitting an Issue to the issue tracker or submitting a pull request.