Skip to content

How to Visualize And Debug Routes

Warning: You are browsing the documentation for Symfony 3.x, which is no longer maintained.

Read the updated version of this page for Symfony 7.1 (the current stable version).

While adding and customizing routes, it's helpful to be able to visualize and get detailed information about your routes. A great way to see every route in your application is via the debug:router console command, which, by default, lists all the configured routes in your application:

1
2
3
4
5
6
7
8
9
10
11
12
$ php bin/console debug:router

------------------ -------- -------- ------ ----------------------------------------------
 Name               Method   Scheme   Host   Path
------------------ -------- -------- ------ ----------------------------------------------
 homepage           ANY      ANY      ANY    /
 contact            GET      ANY      ANY    /contact
 contact_process    POST     ANY      ANY    /contact
 article_show       ANY      ANY      ANY    /articles/{_locale}/{year}/{title}.{_format}
 blog               ANY      ANY      ANY    /blog/{page}
 blog_show          ANY      ANY      ANY    /blog/{slug}
------------------ -------- -------- ------ ----------------------------------------------

You can also get very specific information on a single route by including the route name as the command argument:

1
$ php bin/console debug:router article_show

Likewise, if you want to test whether a URL matches a given route, use the router:match command. This is useful to debug routing issues and find out which route is associated with the given URL:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
$ php bin/console router:match /blog/my-latest-post

Route "blog_show" matches

+--------------+---------------------------------------------------------+
| Property     | Value                                                   |
+--------------+---------------------------------------------------------+
| Route Name   | blog_show                                               |
| Path         | /blog/{slug}                                            |
| Path Regex   | #^/blog/(?P<slug>[^/]++)$#sDu                           |
| Host         | ANY                                                     |
| Host Regex   |                                                         |
| Scheme       | ANY                                                     |
| Method       | ANY                                                     |
| Requirements | NO CUSTOM                                               |
| Class        | Symfony\Component\Routing\Route                         |
| Defaults     | _controller: App\Controller\BlogController:show         |
| Options      | compiler_class: Symfony\Component\Routing\RouteCompiler |
|              | utf8: true                                              |
+--------------+---------------------------------------------------------+
This work, including the code samples, is licensed under a Creative Commons BY-SA 3.0 license.
TOC
    Version