willdurand/negotiation

This new release should be fully compatible with PHP 8.1.

What's Changed

• Added: add missed fallback to generic language (in LanguageNegotiator) by @rtm-ctrlz in #113
• Fixed: invalid PHPDocs return comment by @michalbundyra in #112
• Fixed: incompatibilities with some null values for PHP 8.1 by @W0rma in #114
• Fixed: switch from travis to github actions by @willdurand in #116

New Contributors

• @michalbundyra made their first contribution in #112
• @rtm-ctrlz made their first contribution in #113
• @W0rma made their first contribution in #114

Full Changelog:

See 3.0.0...3.1.0

👋 Hi! It's been a long time.

This new major version is very similar to the 2.x version. In fact, the only main benefit is to support PHP 8, which required some changes that might be considered backward incompatible (see #106).

Upgrade should be safe and it's recommended. This library has been very stable over the years so we didn't change a lot of things between the versions 2 and 3. Have fun!

• Fixed: do not compare + segments unless wildcards in either accept or priority (cf. #93 / #94)

• Added: handle wildcard "+" segments (cf. #92)

This is the very first alpha release of the next major version of this library. This version works almost like the current major version (v2) but fixes a sort of regression for some users that could not be merged into the v2 (cf. version 2.2.1).

💬 Everyone is encouraged to migrate to the v3.

• Added: Implement getOrderedElements() (cf. #90)
• Added: a third optional (boolean) parameter is now available in the getBest($header, array $priorities, $strict = false) method. This parameter allows to throw exceptions if the Accept header is incorrect (default behavior is to silently ignore this case, cf. release 2.0.3).

Fixed: do not compare + segments unless wildcards in either accept or priority (cf. #93 / #94)

• Added: handle wildcard "+" segments (cf. #92)

I revert the code introduced in version 2.2.0 about 2 hours after having released it because the code changed the public API, and therefore introduced a BC break. This version fixes the issue and I am going to publish a new major version for the code previously introduced in 2.2.0.

Please use this version and not 2.2.0

⚠️ PLEASE DO NOT USE THIS VERSION, USE 2.2.1 INSTEAD. SORRY 😕

Added: a third optional (boolean) parameter is now available in the getBest($header, array $priorities, $strict = false) method. This parameter allows to throw exceptions if the Accept header is incorrect (default behavior is to silently ignore this case, cf. release 2.0.3).

⚠️ PLEASE DO NOT USE THIS VERSION, USE 2.2.1 INSTEAD. SORRY 😕

• Added: support for quality-of-source factor (cf. #77)

d26d6b0

UPDATE: Negotiation 2.0.0 has been released on October 1st, 2015.

Hi! It's been a long time, right?

Negotiation is stable for years now, and it works like a charm for most of the common use cases. It has been installed more than two million times. Yes! 2,000,000 . That's awesome!

However, we found tricky edge cases we could not fix easily, and our interpretation of the specification has changed over time. That is why I am proud to announce the immediate availability of Negotiation 2.0 (not entirely stable yet).

This new version is a full rewrite , and therefore it is not backward compatible with Negotiation 1.0. However, migrating should not be too complicated as the API has been drastically simplified : there is only one single method to use now ( getBest() ), and different classes ( Negotiator and *Negotiator ) for different needs.

Here is the first pre-release ( 2.0.0-alpha1 ) of Negotiation 2.0 . Please test it, and report feedback, ideas, bugs so that we can work on providing the best content negotiation library written in PHP ever!

Human Readable Changelog

• Support for wildcard priorities has been removed ( #49 ).

• Register formats have been removed, as well as the logic to retrieve a format given a media type. Hence, isMediaRange() method has been removed. It has been considered out of scope of the library, and it will avoid missing formats, adding too many mapping formats, etc.

• Header parsing has been improved both in term of speed, strictness, and design (for instance, it now accepts quoted parameter).

• Support for partial media ranges has been added.

• The overall negotiation logic has changed ( #45 , #48 , #51 ).

• More named exceptions ( #50 ).

• And, of course, even more tests!

All the commits can be found here: 4dd4643...v2.0.0-alpha1 or in #60 .

Last but not the least, THANK YOU to @neural-wetware for his huge contribution on this new major version! 💛 💙 ❤️ 💚 🚢 ⭐ 🌟 💙 🌠 💝

Let's celebrate now!