minor symfony#16775 [Routing] Allow using services in the route condition (renanbr)

javiereguiluz · javiereguiluz · commit 6a9bc503be36 · 2022-05-05T11:35:32.000+02:00
This PR was merged into the 6.1 branch. Discussion ---------- [Routing] Allow using services in the route condition Documents symfony/symfony#44405 Closes symfony#16714 Commits ------- c2478da [Routing] Allow using services in the route condition
diff --git a/routing.rst b/routing.rst
@@ -462,11 +462,21 @@ and can use any of these variables created by Symfony:
 
     The ``params`` variable was introduced in Symfony 6.1.
 
-You can also use this function:
+You can also use these functions:
 
 ``env(string $name)``
     Returns the value of a variable using :doc:`Environment Variable Processors <configuration/env_var_processors>`
 
+``service(string $alias)``
+    Returns a routing condition service.
+    You'll have to add the ``#[AsRoutingConditionService]`` attribute or ``routing.condition_service``
+    tag to your service if you want to use it in the condition.
+
+.. versionadded:: 6.1
+
+    The ``service(string $alias)`` function and ``#[AsRoutingConditionService]`` attribute
+    was introduced in Symfony 6.1.
+
 Behind the scenes, expressions are compiled down to raw PHP. Because of this,
 using the ``condition`` key causes no extra overhead beyond the time it takes
 for the underlying PHP to execute.
