How to Allow a "/" Character in a Route Parameter
Edit this pageWarning: You are browsing the documentation for Symfony 2.3, which is no longer maintained.
Read the updated version of this page for Symfony 6.1 (the current stable version).
How to Allow a "/" Character in a Route Parameter
Sometimes, you need to compose URLs with parameters that can contain a slash
/. For example, take the classic /hello/{username} route. By default,
/hello/Fabien will match this route but not /hello/Fabien/Kris. This
is because Symfony uses this character as separator between route parts.
This guide covers how you can modify a route so that /hello/Fabien/Kris
matches the /hello/{username} route, where {username} equals Fabien/Kris.
Configure the Route
By default, the Symfony Routing component requires that the parameters
match the following regex path: [^/]+. This means that all characters
are allowed except /.
You must explicitly allow / to be part of your parameter by specifying
a more permissive regex path.
- Annotations
- YAML
- XML
- PHP
1 2 3 4 5 6 7 8 9 10 11 12
use Sensio\Bundle\FrameworkExtraBundle\Configuration\Route;
class DemoController
{
/**
* @Route("/hello/{username}", name="_hello", requirements={"username"=".+"})
*/
public function helloAction($username)
{
// ...
}
}That's it! Now, the {username} parameter can contain the / character.
