symfony/routing

Maps an HTTP request to a set of configuration variables

v7.3.0-RC1 2025-05-24 20:43 UTC

Requires

• php: >=8.2
• symfony/deprecation-contracts: ^2.5|^3

Requires (Dev)

• psr/log: ^1|^2|^3
• symfony/config: ^6.4|^7.0
• symfony/dependency-injection: ^6.4|^7.0
• symfony/expression-language: ^6.4|^7.0
• symfony/http-foundation: ^6.4|^7.0
• symfony/yaml: ^6.4|^7.0

Conflicts

• symfony/config: <6.4
• symfony/dependency-injection: <6.4
• symfony/yaml: <6.4

MIT

• Fabien Potencier
• Symfony Community

• routing
• url
• router
• uri

README

The Routing component maps an HTTP request to a set of configuration variables.

Getting Started

composer require symfony/routing

use App\Controller\BlogController;
use Symfony\Component\Routing\Generator\UrlGenerator;
use Symfony\Component\Routing\Matcher\UrlMatcher;
use Symfony\Component\Routing\RequestContext;
use Symfony\Component\Routing\Route;
use Symfony\Component\Routing\RouteCollection;

$route = new Route('/blog/{slug}', ['_controller' => BlogController::class]);
$routes = new RouteCollection();
$routes->add('blog_show', $route);

$context = new RequestContext();

// Routing can match routes with incoming requests
$matcher = new UrlMatcher($routes, $context);
$parameters = $matcher->match('/blog/lorem-ipsum');
// $parameters = [
//     '_controller' => 'App\Controller\BlogController',
//     'slug' => 'lorem-ipsum',
//     '_route' => 'blog_show'
// ]

// Routing can also generate URLs for a given route
$generator = new UrlGenerator($routes, $context);
$url = $generator->generate('blog_show', [
    'slug' => 'my-blog-post',
]);
// $url = '/blog/my-blog-post'

Sponsor

The Routing component for Symfony 7.1 is backed by redirection.io.

redirection.io logs all your website’s HTTP traffic, and lets you fix errors with redirect rules in seconds. Give your marketing, SEO and IT teams the right tool to manage your website traffic efficiently!

Help Symfony by sponsoring its development!

Resources

• Documentation
• Contributing
• Report issues and send Pull Requests in the main Symfony repository