Fast Route Laravel Package

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

• 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.

• Fixed fallback of static routes to dynamic routes with different allowed HTTP methods. (#50)
• Added routeCollector option to dispatcher functions. (#40)
• The simpleDispatcher() and cachedDispatcher() functions will now only be defined if they do not yet exist, resolving some autoloading issues. (#39)
• Capturing groups inside placeholder regular expressions will now be detected and explicitly forbidden. (#34)

This release changes the structure of the cached data (if cachedDispatcher is used), so the cache file should be removed after the update.

This release adds support for registering a route for multiple HTTP methods at the same time, by passing an array for the method parameter of RouteCollector::addRoute(). For example:

/** [@var](https://github.com/var) RouteCollector $r */
$r->addRoute(['GET', 'POST'], '/foo/{bar}', 'handlerForGetAndPost');

// This is equivalent to:
$r->addRoute('GET', '/foo/{bar}', 'handlerForGetAndPost');
$r->addRoute('POST', '/foo/{bar}', 'handlerForGetAndPost');

This release fixes a routing bug, which could occur if two non-disjoint routes for different HTTP methods are defined:

$dispatcher = FastRoute\simpleDispatcher(function(FastRoute\RouteCollector $r) {
    $r->addRoute('GET',  '/user/{name}', 'GET with default placeholder pattern');
    $r->addRoute('POST', '/user/{name:[a-z]+}', 'POST with custom placeholder pattern');
});

A request to POST /user/foobar was previously rejected with 405 Method Not Supported and is now correctly matched.

For more information see #25.

This release changes the structure of the cached data (if cachedDispatcher is used), so the cache file should be removed after the update.