Need help with laravel-router?
Click the “chat” button below for chat support from the developer who created it, or find similar developers for support.

About the developer

132 Stars 11 Forks MIT License 232 Commits 1 Opened issues


An organized approach to handling routes in Laravel.

Services available


Need anything else?

Contributors list

# 127,969
187 commits

Laravel Router

Latest stable release Software license Build status Total downloads Total stars

Read my blog View my other packages and projects Follow @sebastiaanluca on Twitter Share this package on Twitter

An organized approach to handling routes in Laravel.

This package provides you with an easy-to-use system to separate route logic into routers based on functionality while also providing additional functionality. A replacement for those bulky

route files that are often lacking any structure and break Laravel structure conventions of separating everything in classes instead of regular PHP files.

Do note that it changes nothing to the way you define your routes. It's just a way of organizing them. Optionally you can use the additional functionality it provides, but that's not a requirement.

Table of contents


  • PHP 7.3 or higher
  • Laravel 7.0 or higher

Looking for support for earlier versions? Try out any of the previous package versions.

How to install

Just add the package to your project using Composer and Laravel will auto-discover it:

composer require sebastiaanluca/laravel-router

Further optional setup

If you want to be able to register your routers in a single place, add the

trait to your HTTP kernel (found at
use Illuminate\Foundation\Http\Kernel as HttpKernel;
use SebastiaanLuca\Router\Kernel\RegistersRouters;

class Kernel extends HttpKernel { use RegistersRouters; }

How to use

Creating a router

The following is an example of a router. It can be placed anywhere you like, though I'd suggest grouping them in the

use SebastiaanLuca\Router\Routers\Router;

class UserRouter extends Router { /** * Map the routes. */ public function map() { $this->router->group(['middleware' => ['web', 'guest']], function () {

        $this->router->get('/users', function () {

            return view('users.index');





method is where you should define your routes and is the only requirement when using a router. The Laravel routing instance is automatically resolved from the IoC container, so you can use any standard routing functionality you want. Of course you can also use the

Registering the router

To automatically have the framework load your router and map its routes, add the trait and add the router to the

array in your application's HTTP kernel class:
 * The application routers to automatically boot.
 * @var array
protected $routers = [

Manually registering the router

If you don't want to or can't add the trait to the kernel, you can also register the router manually by just instantiating it (in a service provider for instance). The parent base router will automatically resolve all dependencies and call the

method on your router.

Especially useful in packages!

Optional features

To use the following optional features, register the

use Illuminate\Foundation\Http\Kernel as HttpKernel;
use SebastiaanLuca\Router\Kernel\RegistersRouters;

class Kernel extends HttpKernel { use RegistersRouters;

 * The application routers to automatically boot.
 * @var array
protected $routers = [


Common route parameter patterns

Laravel provides a convenient way to validate URL parameters using patterns in routes. This package provides a predefined set of such patterns so you don't have to repeatedly add them to each route or define them yourself. The following parameter patterns are currently included:

  • id (
  • hash (
  • uuid (
  • slug (
  • token (

So forget about writing:

Route::get('user/activations/{uuid}', function ($uuid) {
    return view('');
})->where('uuid', '[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}');

Just use the

or any other pattern in your route:
$this->router->get('user/activations/{uuid}', function ($uuid) {
    return view('');

Full-domain routing

Another great feature of Laravel is sub-domain routing which allows you to handle multiple subdomains within a single Laravel project. The only caveat there is that it only does that and doesn't handle full domains.

Laravel Router fixes that for you so you can direct multiple domains to a single Laravel project and handle them all at once. Simply define a route group with the

pattern and use it in your callback or controller:
$this->router->group(['domain' => '{domain}'], function () {

$this->router->get('user/{id}', function ($domain, $id) {
    return 'You\'re visiting from ' . $domain;



This package operates under the MIT License (MIT). Please see LICENSE for more information.

Change log

Please see CHANGELOG for more information what has changed recently.


composer install
composer test


Please see CONTRIBUTING and CONDUCT for details.


If you discover any security related issues, please email [email protected] instead of using the issue tracker.



My name is Sebastiaan and I'm a freelance Laravel developer specializing in building custom Laravel applications. Check out my portfolio for more information, my blog for the latest tips and tricks, and my other packages to kick-start your next project.

Have a project that could use some guidance? Send me an e-mail at [email protected]!

We use cookies. If you continue to browse the site, you agree to the use of cookies. For more information on our use of cookies please see our Privacy Policy.