[Routing] Add params variable to condition expression

HypeMC · HypeMC · commit 344bd7e85824 · 2022-04-23T08:40:12.000+02:00
diff --git a/routing.rst b/routing.rst
@@ -323,12 +323,24 @@ arbitrary matching logic:
              * )
              *
              * expressions can also include configuration parameters:
-             * condition: "request.headers.get('User-Agent') matches '%app.allowed_browsers%'"
+             * condition="request.headers.get('User-Agent') matches '%app.allowed_browsers%'"
              */
             public function contact(): Response
             {
                 // ...
             }
+
+            /**
+             * @Route(
+             *     "/posts/{id}",
+             *     name="post_show",
+             *     condition="params['id'] < 1000"
+             * )
+             */
+            public function showPost(int $id): Response
+            {
+                // ... return a JSON response with the post
+            }
         }
 
     .. code-block:: php-attributes
@@ -353,6 +365,16 @@ arbitrary matching logic:
             {
                 // ...
             }
+
+            #[Route(
+                '/posts/{id}',
+                name: 'post_show',
+                condition: "params['id'] < 1000"
+            )]
+            public function showPost(int $id): Response
+            {
+                // ... return a JSON response with the post
+            }
         }
 
     .. code-block:: yaml
@@ -367,6 +389,11 @@ arbitrary matching logic:
             # expressions can even use environment variables:
             # condition: "context.getHost() == env('APP_MAIN_HOST')"
 
+        post_show:
+            path:       /posts/{id}
+            controller: 'App\Controller\DefaultController::showPost'
+            condition:  "params['id'] < 1000"
+
     .. code-block:: xml
 
         <!-- config/routes.xml -->
@@ -383,6 +410,10 @@ arbitrary matching logic:
                 <!-- expressions can even use environment variables: -->
                 <!-- <condition>context.getHost() == env('APP_MAIN_HOST')</condition> -->
             </route>
+
+            <route id="post_show" path="/posts/{id}" controller="App\Controller\DefaultController::showPost">
+                <condition>params['id'] &lt; 1000</condition>
+            </route>
         </routes>
 
     .. code-block:: php
@@ -400,6 +431,10 @@ arbitrary matching logic:
                 // expressions can even use environment variables:
                 // ->condition('context.getHost() == env("APP_MAIN_HOST")')
             ;
+            $routes->add('post_show', '/posts/{id}')
+                ->controller([DefaultController::class, 'showPost'])
+                ->condition('params["id"] < 1000')
+            ;
         };
 
 The value of the ``condition`` option is any valid
@@ -414,6 +449,14 @@ and can use any of these variables created by Symfony:
     The :ref:`Symfony Request <component-http-foundation-request>` object that
     represents the current request.
 
+``params``
+    An array of matched :ref:`route parameters <routing-route-parameters>` for
+    the current route.
+
+.. versionadded:: 6.1
+
+    The ``params`` variable was introduced in Symfony 6.1.
+
 You can also use this function:
 
 ``env(string $name)``
@@ -478,6 +521,8 @@ controller action that you expect:
 
       [OK] Route "app_lucky_number" matches
 
+.. _routing-route-parameters:
+
 Route Parameters
 ----------------
 
