PHPackages                             proteins/negotiation - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [HTTP & Networking](/categories/http)
4. /
5. proteins/negotiation

ActiveLibrary[HTTP & Networking](/categories/http)

proteins/negotiation
====================

A module for handling Content Negotiation

1.0.3(6y ago)0441MITPHPPHP ^7.2

Since May 28Pushed 6y ago1 watchersCompare

[ Source](https://github.com/php-protein/negotiation)[ Packagist](https://packagist.org/packages/proteins/negotiation)[ RSS](/packages/proteins-negotiation/feed)WikiDiscussions master Synced 2d ago

READMEChangelogDependenciesVersions (4)Used By (1)

[![](https://raw.githubusercontent.com/php-protein/docs/master/assets/protein-large.png)](https://raw.githubusercontent.com/php-protein/docs/master/assets/protein-large.png)

Protein | Negotiation
=====================

[](#protein--negotiation)

A module for handling Content Negotiation.
------------------------------------------

[](#a-module-for-handling-content-negotiation)

> See Reference : [RFC 7231](https://tools.ietf.org/html/rfc7231)

### Install

[](#install)

---

```
composer require proteins/negotiation

```

Require the class via :

```
use Proteins\Negotiation;
```

### Get best match between need and offerings

[](#get-best-match-between-need-and-offerings)

---

> **Note:** You can use `*` as wildcards for matching a family of choices.

```
$need  = 'image/*;q=0.9,*/*;q=0.2';
$offer = 'text/html,svg/xml,image/svg+xml';
echo Negotiation::bestMatch($need,$offer);
```

```
image/svg+xml

```

### Preferred and best match

[](#preferred-and-best-match)

---

Negotiation class automatically orders by priority based on `q` parameter.

```
$negotiatior = new Negotiation('en-US;q=0.3,it,en;q=0.4,es;q=0.9,de');
```

You can obtain the preferred response via the `preferred` method.

```
echo $negotiatior->preferred();
```

```
it

```

Or get the best match against another RFC7231 query

```
echo $negotiatior->best('es,en-US');
```

```
es

```

`false` will be returned if no match can be found.

###  Health Score

26

—

LowBetter than 43% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity8

Limited adoption so far

Community9

Small or concentrated contributor base

Maturity56

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 100% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~0 days

Total

3

Last Release

2543d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/b00a7323d0ef535e352696bc141305b3928fce777a0f477109d2274ad17cdb9f?d=identicon)[lastguest](/maintainers/lastguest)

---

Top Contributors

[![lastguest](https://avatars.githubusercontent.com/u/178900?v=4)](https://github.com/lastguest "lastguest (3 commits)")

### Embed Badge

![Health badge](/badges/proteins-negotiation/health.svg)

```
[![Health](https://phpackages.com/badges/proteins-negotiation/health.svg)](https://phpackages.com/packages/proteins-negotiation)
```

###  Alternatives

[friendsofsymfony/rest-bundle

This Bundle provides various tools to rapidly develop RESTful API's with Symfony

2.8k73.3M319](/packages/friendsofsymfony-rest-bundle)[php-http/discovery

Finds and installs PSR-7, PSR-17, PSR-18 and HTTPlug implementations

1.3k309.5M1.2k](/packages/php-http-discovery)[nyholm/psr7

A fast PHP7 implementation of PSR-7

1.3k235.4M2.4k](/packages/nyholm-psr7)[pusher/pusher-php-server

Library for interacting with the Pusher REST API

1.5k94.8M293](/packages/pusher-pusher-php-server)[spatie/crawler

Crawl all internal links found on a website

2.8k16.3M52](/packages/spatie-crawler)[react/http

Event-driven, streaming HTTP client and server implementation for ReactPHP

78126.4M414](/packages/react-http)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)