That's it. You now have some enhanced functionality available to your routes.

Features

Set where requirements on route group prefixes and domains.

Use the before and after methods to apply filters to an entire route group.

Set filters to run on an HTTP verb or an array of HTTP verbs.

Using Enhanced Router

Once you have the package installed and the service provider in your providers key you can begin using the features right away.

Route Group Prefixes

Using the Laravel 4 router there is no way to set a requirement on a prefix. What this means is that prefixes themselves are hard-coded. There are a number of real-world scenarios where being able to use variable prefixes is very useful.

Let's say you're building an application that has localization support and you're currently prefixing all your routes with the locale.

For a small application this might suffice. But once your application gets quite large it can become a bit of a smell. And when it comes time to add another language you'll need to go through all the routes and add the language.

Using Enhanced Router you can set the requirement itself on the group. This means you only need to define the requirement once, and adding languages in the future isn't so painful.

Parameters

It's important to note that the locale is actually given to each route as a parameter. The parameter is also given to every method of every controller that is within the group. When your route requires a parameter of its own it will be given after the prefix parameter.

Subdomain Routing

Using route groups in Laravel 4 you can specify the domain the group responds to. This is especially helpful when you want to route to a subdomain. Currently you can only route to a single subdomain or every subdomain.

Now the group will only match the subdomains jason.laravel.dev and shawn.laravel.dev.

Filters

Route Groups

Filters can now be applied to a group using the fluent syntax you might be familiar with from routes. The only thing to be aware of here is that you still need to provide an array as the first parameter to the group.

Route::group(array(), function(){})->before('auth');

All filters in the group will now have the auth filter applied to them. When you have nested groups with filters applied to them the outermost filters are applied first since they are actually defined first.

The above example would trigger the auth filter first and then move on to the csrf filter if the matched route was within that group.

Because of type hinting in the Laravel 4 router it's difficult to remove the empty array from the first parameter. If you aren't using a prefix or subdomain routing then you can use the new bunch method.

Route::bunch(function(){})->before('auth');

This method is the same as group except you don't have to pass in an array as the first parameter.

HTTP Verbs

Enhanced Router allows you to apply filters to all routes for specific HTTP verbs. Consider an application where all POST requests require the csrf filter.

Route::on('post', 'csrf');

Or you can use an array of verbs.

Route::on(['post', 'put'], 'csrf');

You can also use an array of filters to apply.

Route::on(['post', 'put'], ['csrf', 'auth']);

More Examples

This example shows how you can nest groups and use filters, domains, and prefixes all at once.