ptlis/conneg

Tools for performing content negotiation.

ConNeg

Content Negotiation for PHP., _(*1)

This framework-independent library provides tooling to allow you to support content negotiation in your applications., _(*2)

Supports negotiation on the Accept, Accept-Charset, Accept-Encoding and Accept-Language fields in a HTTP header., _(*3)

, _(*4)

Install

With composer:, _(*5)

$ composer require ptlis/conneg:~4.0.0

Usage

In a PSR-7 Project

If your application supports PSR-7 then the simplest way to get content negotiation is via the middlewares provided by ptlis/psr7-conneg., _(*6)

In non PSR-7 Projects

First create a Negotiation instance. This provides methods to perform negotiation on client and server preferences., _(*7)

use ptlis\ConNeg\Negotiation;

$negotiation = new Negotiation();

In most cases your application will only care about the best match, to get these we can use the *Best() methods., _(*8)

For example, negotiation to decide whether to serve JSON or XML (preferring JSON) would look like:, _(*9)

$bestMime = $negotiation->mimeBest(
    $_SERVER['ACCEPT'], 
    'application/json;q=1,application/xml;q=0.75'
);

This will return a string representation of the best matching mime-type specified by the server's preferences, for example 'application/json'., _(*10)

Negotiation of Language, Encoding & Charset can be done by using the appropriate method (languageBest, encodingBest & charsetBest respectively)., _(*11)

Note: server preferences a string-encoded as described in the documentation., _(*12)

See the detailed usage docs for further (more complex) examples., _(*13)

Documentation

Full Documentation, _(*14)

Integration

• PSR-7 via the ptlis/psr7-conneg package, with middlewares supporting:
  • Zend Stratigility
  • Relay
• Symfony2 via the ptlis/conneg-bundle Bundle.

Contributing

You can contribute by submitting an Issue to the issue tracker, improving the documentation, integrating the library into your framework of choice or submitting a pull request. For pull requests i'd prefer that the code style and test coverage is maintained, but I am happy to work through any minor issues that may arise so that the request can be merged., _(*15)

TODO

• Time based negotiation? See RFC 7089