diff --git a/components/routing/introduction.rst b/components/routing/introduction.rst index a0b84b85d25..b565d33582e 100644 --- a/components/routing/introduction.rst +++ b/components/routing/introduction.rst @@ -62,11 +62,15 @@ URL path and some array of custom variables in its constructor. This array of custom variables can be *anything* that's significant to your application, and is returned when that route is matched. -If no matching route can be found a -:class:`Symfony\\Component\\Routing\\Exception\\ResourceNotFoundException` will be thrown. +The :method:`UrlMatcher::match() ` +returns the variables you set on the route as well as the wildcard placeholders +(see below). Your application can now use this information to continue +processing the request. In addition to the configured variables, a ``_route`` +key is added, which holds the name of the matched route. -In addition to your array of custom variables, a ``_route`` key is added, -which holds the name of the matched route. +If no matching route can be found, a +:class:`Symfony\\Component\\Routing\\Exception\\ResourceNotFoundException` will +be thrown. Defining Routes ~~~~~~~~~~~~~~~ @@ -126,6 +130,9 @@ In this case, the route is matched by ``/archive/2012-01``, because the ``{month wildcard matches the regular expression wildcard given. However, ``/archive/foo`` does *not* match, because "foo" fails the month wildcard. +When using wildcards, these are returned in the resulting array of calling +``match``. The part of the path that the wildcard matched is used as value. + .. tip:: If you want to match all URLs which start with a certain path and end in an