nikic/fast-route

This is a pre-release of FastRoute containing all recent improvements.
It's meant for enabling downstream testing, specially the detection of unexpected BC-breaks.

In the meantime we'll be updating the documentation and dealing with any undesired breakage.

Check all changes in https://github.com/nikic/FastRoute/milestone/1?closed=1

This release ports the .gitattributes configuration to reduce the size
of distribution files.

• Improve type usage in doc comments.
• Switch coding style to PSR-2.
• Mark shape keys in FastRoute.hhi as optional. This adds support for HHVM >= 3.23 and removes support for HHVM < 3.23.

• Added support for route groups.
• Made some RouteCollector properties protected instead of private.

Fixed

• If the cacheDisabled option is enabled, the cache file is no longer written. Previously it was not read, but still written. (#114)

Added

• Added convenience methods get(), post(), put(), delete(), patch() and head() to the RouteCollector. (#109)

Placeholder names may now start with an underscore (_) character.

This is a re-release of version 0.8.0 without code changes. Given the number of dependent projects there should be a formally stable release :)

• Fixed fallback from HEAD to GET if dynamic HEAD routes are defined.
• First check all HEAD routes before attempting a GET fallback.
• Add support for hyphens in placeholder names.
• (Experimental.) Add support for fallback routes that match any method. These are specified using a * method and matched after all other routes.

• Add HHI file for Hack typechecking support. The HHI file requires HHVM 3.9 or newer.
• Fix support for empty routes.
• Improve error message if optional part is not at the end of a route.

Added support for trailing optional segments, for example the route

$r->addRoute('GET', '/foo[/{bar}[/{baz}]]', 'handler');

is equivalent to the three routes

$r->addRoute('GET', '/foo', 'handler');
$r->addRoute('GET', '/foo/{bar}', 'handler');
$r->addRoute('GET', '/foo/{bar}/{baz}', 'handler');

As a result of this additional the output format for RouteParser was changed to add another array level, which may need to be accounted for if you use a custom parser.