From 5cac5edd2cdad1a1494ffc2cea13dee6b188727e Mon Sep 17 00:00:00 2001
From: Santiago San Martin <sanmartindev@gmail.com>
Date: Thu, 7 Aug 2025 19:20:05 -0300
Subject: [PATCH] [Routing] correct environment-specific routing configuration
 examples

---
 routing.rst | 23 ++++++++++++-----------
 1 file changed, 12 insertions(+), 11 deletions(-)

diff --git a/routing.rst b/routing.rst
index 102aef454f0..541ba971f67 100644
--- a/routing.rst
+++ b/routing.rst
@@ -282,10 +282,10 @@ given value:
     .. code-block:: yaml
 
         # config/routes.yaml
-        tools:
-            path:       /tools
-            controller: App\Controller\DefaultController::developerTools
-            env:        dev
+        when@dev:
+            tools:
+                path: /tools
+                controller: App\Controller\DefaultController::developerTools
 
     .. code-block:: xml
 
@@ -296,9 +296,9 @@ given value:
             xsi:schemaLocation="http://symfony.com/schema/routing
                 https://symfony.com/schema/routing/routing-1.0.xsd">
 
-            <route id="tools" path="/tools" controller="App\Controller\DefaultController::developerTools">
-                <env>dev</env>
-            </route>
+            <when env="dev">
+                <route id="tools" path="/tools" controller="App\Controller\DefaultController::developerTools"/>
+            </when>
         </routes>
 
     .. code-block:: php
@@ -308,10 +308,11 @@ given value:
         use Symfony\Component\Routing\Loader\Configurator\RoutingConfigurator;
 
         return function (RoutingConfigurator $routes): void {
-            $routes->add('tools', '/tools')
-                ->controller([DefaultController::class, 'developerTools'])
-                ->env('dev')
-            ;
+            if('dev' === $routes->env()) {
+                $routes->add('tools', '/tools')
+                    ->controller([DefaultController::class, 'developerTools'])
+                ;
+            }
         };
 
 .. _routing-matching-expressions: