Update session.rst

Co-authored-by: Wouter de Jong <[email protected]>

Author: fabpot

_build/redirection_map

@@ -248,8 +248,8 @@
 /cookbook/session/index /session
 /cookbook/session/limit_metadata_writes /reference/configuration/framework
 /session/limit_metadata_writes /reference/configuration/framework
-/cookbook/session/locale_sticky_session /session
-/cookbook/locale_sticky_session /session
+/cookbook/session/locale_sticky_session /session#locale-sticky-session
+/cookbook/locale_sticky_session /session#locale-sticky-session
 /cookbook/session/php_bridge /session/php_bridge
 /cookbook/session/proxy_examples /session/proxy_examples
 /cookbook/session/sessions_directory /session/sessions_directory
@@ -478,9 +478,9 @@
 /components/translation/custom_message_formatter https://github.com/symfony/translation
 /components/notifier https://github.com/symfony/notifier
 /components/routing https://github.com/symfony/routing
-/session/database /session
-/doctrine/pdo_session_storage /session
-/doctrine/mongodb_session_storage /session
+/session/database /session#session-database
+/doctrine/pdo_session_storage /session#session-database-pdo
+/doctrine/mongodb_session_storage /session#session-database-mongodb
 /components/dotenv https://github.com/symfony/dotenv
 /components/mercure /mercure
 /components/polyfill_apcu https://github.com/symfony/polyfill-apcu

session.rst

@@ -13,7 +13,7 @@ subsystem which is designed to provide session management that you can use to
 store information about the user between requests through a clear
 object-oriented interface using a variety of session storage drivers.
 
-You need to install HttpFoundation to handle sessions:
+You need to install the HttpFoundation component to handle sessions:
 
 .. code-block:: terminal
 
@@ -101,9 +101,9 @@ From a Symfony controller, type-hint an argument with
 Attributes
 ----------
 
-PHP's session management requires the use of the ``$_SESSION`` super-global,
-however, this interferes somewhat with code testability and encapsulation in an
-OOP paradigm. To help overcome this, Symfony uses *session bags* linked to the
+PHP's session management requires the use of the ``$_SESSION`` super-global.
+However, this interferes with code testability and encapsulation in an OOP
+paradigm. To help overcome this, Symfony uses *session bags* linked to the
 session to encapsulate a specific dataset of **attributes**.
 
 This approach mitigates namespace pollution within the ``$_SESSION``
@@ -466,18 +466,17 @@ installed and configured the `phpredis extension`_.
 
 You have two different options to use Redis to store sessions:
 
-(1) The first PHP-based option is to configure Redis session handler directly
-    in the server ``php.ini`` file:
+The first PHP-based option is to configure Redis session handler directly
+in the server ``php.ini`` file:
 
 .. code-block:: ini
 
     ; php.ini
     session.save_handler = redis
     session.save_path = "tcp://192.168.0.178:6379?auth=REDIS_PASSWORD"
 
-(2) The second Symfony-based option is to configure Redis sessions as follows.
-
-First, define a Symfony service for the connection to the Redis server:
+The second option is to configure Redis sessions in Symfony. First, define
+a Symfony service for the connection to the Redis server:
 
 .. configuration-block::
 
@@ -567,18 +566,26 @@ and ``RedisProxy``:
     .. code-block:: xml
 
         <!-- config/services.xml -->
-        <services>
-            <service id="Symfony\Component\HttpFoundation\Session\Storage\Handler\RedisSessionHandler">
-                <argument type="service" id="Redis"/>
-                <!-- you can optionally pass an array of options. The only options are 'prefix' and 'ttl',
-                     which define the prefix to use for the keys to avoid collision on the Redis server
-                     and the expiration time for any given entry (in seconds), defaults are 'sf_s' and null:
-                <argument type="collection">
-                    <argument key="prefix">my_prefix</argument>
-                    <argument key="ttl">600</argument>
-                </argument> -->
-            </service>
-        </services>
+        <!-- config/services.xml -->
+        <?xml version="1.0" encoding="UTF-8" ?>
+        <container xmlns="http://symfony.com/schema/dic/services"
+            xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+            xsi:schemaLocation="http://symfony.com/schema/dic/services
+                https://symfony.com/schema/dic/services/services-1.0.xsd">
+                
+            <services>
+                <service id="Symfony\Component\HttpFoundation\Session\Storage\Handler\RedisSessionHandler">
+                    <argument type="service" id="Redis"/>
+                    <!-- you can optionally pass an array of options. The only options are 'prefix' and 'ttl',
+                         which define the prefix to use for the keys to avoid collision on the Redis server
+                         and the expiration time for any given entry (in seconds), defaults are 'sf_s' and null:
+                    <argument type="collection">
+                        <argument key="prefix">my_prefix</argument>
+                        <argument key="ttl">600</argument>
+                    </argument> -->
+                </service>
+            </services>
+        </container>
 
     .. code-block:: php
 
@@ -612,10 +619,20 @@ configuration option to tell Symfony to use this service as the session handler:
     .. code-block:: xml
 
         <!-- config/packages/framework.xml -->
-        <framework:config>
-            <!-- ... -->
-            <framework:session handler-id="Symfony\Component\HttpFoundation\Session\Storage\Handler\RedisSessionHandler"/>
-        </framework:config>
+        <?xml version="1.0" encoding="UTF-8" ?>
+        <container xmlns="http://symfony.com/schema/dic/services"
+            xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+            xmlns:framework="http://symfony.com/schema/dic/symfony"
+            xsi:schemaLocation="http://symfony.com/schema/dic/services
+                https://symfony.com/schema/dic/services/services-1.0.xsd
+                http://symfony.com/schema/dic/symfony
+                https://symfony.com/schema/dic/symfony/symfony-1.0.xsd">
+
+            <framework:config>
+                <!-- ... -->
+                <framework:session handler-id="Symfony\Component\HttpFoundation\Session\Storage\Handler\RedisSessionHandler"/>
+            </framework:config>
+        </container>
 
     .. code-block:: php
 
@@ -642,6 +659,8 @@ and only the first one stored the CSRF token in the session.
     replace ``RedisSessionHandler`` by
     :class:`Symfony\\Component\\HttpFoundation\\Session\\Storage\\Handler\\MemcachedSessionHandler`.
 
+.. _session-database-pdo:
+
 Store Sessions in a Relational Database (MariaDB, MySQL, PostgreSQL)
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
@@ -737,11 +756,21 @@ configuration option to tell Symfony to use this service as the session handler:
     .. code-block:: xml
 
         <!-- config/packages/framework.xml -->
-        <framework:config>
-            <!-- ... -->
-            <framework:session
-                handler-id="Symfony\Component\HttpFoundation\Session\Storage\Handler\PdoSessionHandler"/>
-        </framework:config>
+        <?xml version="1.0" encoding="UTF-8" ?>
+        <container xmlns="http://symfony.com/schema/dic/services"
+            xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+            xmlns:framework="http://symfony.com/schema/dic/symfony"
+            xsi:schemaLocation="http://symfony.com/schema/dic/services
+                https://symfony.com/schema/dic/services/services-1.0.xsd
+                http://symfony.com/schema/dic/symfony
+                https://symfony.com/schema/dic/symfony/symfony-1.0.xsd">
+
+            <framework:config>
+                <!-- ... -->
+                <framework:session
+                    handler-id="Symfony\Component\HttpFoundation\Session\Storage\Handler\PdoSessionHandler"/>
+            </framework:config>
+        </container>
 
     .. code-block:: php
 
@@ -925,6 +954,8 @@ Microsoft SQL Server
         INDEX sessions_sess_lifetime_idx (sess_lifetime)
     );
 
+.. _session-database-mongodb:
+
 Store Sessions in a NoSQL Database (MongoDB)
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
@@ -1000,11 +1031,21 @@ configuration option to tell Symfony to use this service as the session handler:
     .. code-block:: xml
 
         <!-- config/packages/framework.xml -->
-        <framework:config>
-            <!-- ... -->
-            <framework:session
-                handler-id="Symfony\Component\HttpFoundation\Session\Storage\Handler\MongoDbSessionHandler"/>
-        </framework:config>
+        <?xml version="1.0" encoding="UTF-8" ?>
+        <container xmlns="http://symfony.com/schema/dic/services"
+            xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+            xmlns:framework="http://symfony.com/schema/dic/symfony"
+            xsi:schemaLocation="http://symfony.com/schema/dic/services
+                https://symfony.com/schema/dic/services/services-1.0.xsd
+                http://symfony.com/schema/dic/symfony
+                https://symfony.com/schema/dic/symfony/symfony-1.0.xsd">
+
+            <framework:config>
+                <!-- ... -->
+                <framework:session
+                    handler-id="Symfony\Component\HttpFoundation\Session\Storage\Handler\MongoDbSessionHandler"/>
+            </framework:config>
+        </container>
 
     .. code-block:: php