symfony/routing

Maps an HTTP request to a set of configuration variables

v6.3.3 2023-07-31 07:08 UTC

Requires

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

Requires (Dev)

• doctrine/annotations: ^1.12|^2
• psr/log: ^1|^2|^3
• symfony/config: ^6.2
• symfony/dependency-injection: ^5.4|^6.0
• symfony/expression-language: ^5.4|^6.0
• symfony/http-foundation: ^5.4|^6.0
• symfony/yaml: ^5.4|^6.0

Conflicts

• doctrine/annotations: <1.12
• symfony/config: <6.2
• symfony/dependency-injection: <5.4
• symfony/yaml: <5.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'

Resources

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