[Security] Document the LogoutRouteLoader

MatTheCat · MatTheCat · commit e6bd0f9b59a7 · 2023-10-06T16:30:32.000+02:00
diff --git a/security.rst b/security.rst
@@ -1846,7 +1846,53 @@ To enable logging out, activate the  ``logout`` config parameter under your fire
             ;
         };
 
-Next, you need to create a route for this URL (but not a controller):
+``path`` can be either a route name, or a URI.
+
+Since Symfony 6.4, you can leverage the
+:class:`Symfony\\Bundle\\SecurityBundle\\Routing\\LogoutRouteLoader`
+to automatically register a route for every logout URI you configured.
+If your project uses :ref:`Symfony Flex <symfony-flex>`,
+this is already done for you.
+Otherwise, you need to import the ``security.route_loader.logout`` service
+as a routing resource:
+
+.. configuration-block::
+
+    .. code-block:: yaml
+
+        # config/routes/security.yaml
+        logout:
+            resource: security.route_loader.logout
+            type: service
+
+    .. code-block:: xml
+
+        <!-- config/routes/security.xml -->
+        <?xml version="1.0" encoding="UTF-8" ?>
+        <routes xmlns="http://symfony.com/schema/routing"
+            xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+            xsi:schemaLocation="http://symfony.com/schema/routing
+                https://symfony.com/schema/routing/routing-1.0.xsd">
+
+            <import resource="security.route_loader.logout" type="service"/>
+        </routes>
+
+    .. code-block:: php
+
+        // config/routes/security.php
+        use Symfony\Component\Routing\Loader\Configurator\RoutingConfigurator;
+
+        return static function (RoutingConfigurator $routes): void {
+            $routes->import('security.route_loader.logout', 'service');
+        };
+
+.. versionadded:: 6.4
+
+    The :class:`Symfony\\Bundle\\SecurityBundle\\Routing\\LogoutRouteLoader` was
+    introduced in Symfony 6.4.
+
+Another option is to create a route matching the name or URI you configured as
+``path``. You don't have to associate a controller because it wouldn't be called:
 
 .. configuration-block::
 
